What it returns
The World Agricultural Supply and Demand Estimates (WASDE) report moves grain, oilseed, cotton, sugar and livestock markets every month. This API returns every number in it as a clean row, straight from USDA, for every report from April 2010 to the latest one.
US and world balance sheets** for corn, soybeans (and meal and oil), wheat (by class), coarse grains, sorghum, barley, oats, rice, cotton, sugar, meats, poultry, eggs and dairy. Every line item**: area, yield, production, imports, exports, feed, food and industrial use, ending stocks, season-average farm price. Change from the previous report** on every row (`previousValue`, `change`, `changePct`), so a revision is one filter away (`changesOnly`). Release date and time (12:00 ET), WASDE number, market year, and whether the figure is a projection, estimate or actual.
Request
POST https://api.pushbuild.com/usda-wasde-crop-forecasts/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
months | list of strings | Specific WASDE reports as YYYY-MM, e.g. 2026-10. Leave empty for the latest report. |
monthFrom | string | YYYY-MM. Every report from this month on (used when Report months is empty). Data starts 2010-04. |
monthTo | string | YYYY-MM. Last report month to include. |
commodities | list of strings | Commodity name contains, e.g. Corn, Soybean, Wheat, Cotton, Rice, Sugar, Beef, Milk. |
regions | list of strings | Region contains, e.g. United States, World, China, Brazil, EU. |
attributes | list of strings | Line item contains, e.g. Production, Yield, Exports, Ending Stocks, Price. |
reportTitles | list of strings | Table title contains, e.g. 'U.S. Wheat by Class' or 'World Soybean'. |
projectionsOnly | boolean | Only the forward market-year projections, not estimates or past years. Default: false. |
compareToPrevious | boolean | Adds previousValue, change and changePct from the prior month's report. Default: true. |
changesOnly | boolean | Only rows whose value changed from the previous report. Default: false. |
includeReliability | boolean | Also return USDA's historical forecast-accuracy tables. Default: false. |
maxReports | integer | Newest reports first when a range is given. Default: 24. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/usda-wasde-crop-forecasts/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"commodities": ["Corn"], "regions": ["United States"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.40 per 1,000 rows. No charge for errors or empty searches.
Related APIs
Bank of England API: Bank Rate, SONIA, Gilts & Mortgages API
Bank of England statistics from its official database: Bank Rate, SONIA, gilt yields, implied inflation, mortgage rates and approvals, M4 money, lending and sterling FX.
BLS Data API: Any Bureau of Labor Statistics Series API
Any US Bureau of Labor Statistics time series by id (CPI, payrolls by industry, unemployment, wages, PPI, JOLTS, import prices) plus state unemployment and labor force from plain state codes, with month-over-month and year-over-year changes..
Cboe Put/Call Ratios & VIX Futures Term Structure API
Daily Cboe options statistics: total, equity, index, SPX and VIX put/call ratios with call and put volume and open interest by product, plus the VIX futures curve with settlements, open interest and contango versus spot VIX..
CFPB Consumer Complaints: Banks, Lenders, Fintech API
Search 18 million+ official CFPB consumer complaints against banks, lenders, card issuers, debt collectors, credit bureaus and fintechs.
CFTC Commitments of Traders (COT) Reports API
Weekly CFTC Commitments of Traders positioning for every futures market: legacy, disaggregated (managed money, producers, swap dealers) and financial (leveraged funds, asset managers).
ClinicalTrials.gov API
Search 500,000+ clinical studies from ClinicalTrials.gov by condition, drug, sponsor, location, phase and status.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com