psd_report

Download one, or more, USDA FAS commodity PSD circulars.

This command returns only the results portion of the OBBject response. It contains a list of dictionaries where the base64 encoded content of the document is under the 'content' key.

Examples

from openbb import obb
obb.usda.psd_report(provider='usda', urls=['https://apps.fas.usda.gov/PSDOnline/Circulars/2026/01/Citrus.pdf'])
# List the latest circular for every commodity, then download them.
urls = [d['value'] for d in obb.usda.psd_report_urls()]
pdfs = obb.usda.psd_report(urls=urls)

Parameters

• standard
• usda

urls: dict[str, list[str]] | list[str] | str | list[dict[str, list[str]] | list[str] | str]
Circular URLs to download, as returned by the psd_report_urls endpoint. Multiple items allowed.

---

Returns

Any

Data

• standard
• usda

error_type: str | None
Error type, if the circular could not be downloaded.

content: str
Base64-encoded PDF document.

filename: str | None
The filename of the downloaded PDF.

data_format: dict[str, str] | None
Data format information, including data type and filename.