bell_report

Download one, or more, USDA FAS Bell Reports.

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.bell_report(provider='usda', urls=['https://apps.fas.usda.gov/esrqs/ReportsHome.aspx?RN=BR&wed=07%2F03%2F2025&YGO=07%2F04%2F2024&RD=07%2F10%2F2025&MY=N&CID=1%2C&AppUserId=0'])
# List the reports published for wheat and corn, then download them.
urls = [d['value'] for d in obb.usda.bell_report_urls(commodity_code='101,401')]
pdfs = obb.usda.bell_report(urls=urls)

Parameters

• standard
• usda

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

---

Returns

Any

Data

• standard
• usda

error_type: str | None
Error type, if the report 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.