What it returns
Official US agricultural statistics from USDA NASS Quick Stats: crop yield, production, acres planted and harvested, prices received, stocks, livestock inventory, dairy and the Census of Agriculture, nationally, by state and by county, with value lists for every filter.
Request
POST https://api.pushbuild.com/usda-nass-agriculture-statistics/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
commodity | string | Comma separated, e.g. CORN, SOYBEANS, WHEAT, CATTLE, MILK |
statistic | string | e.g. YIELD, PRODUCTION, AREA PLANTED, AREA HARVESTED, PRICE RECEIVED, INVENTORY |
level | string: , national, state, county, district | national, state, county or agricultural district Default: "". |
state | string | Two-letter codes, comma separated, e.g. IA,IL |
county | string | e.g. STORY (with state) |
year | string | Comma separated, e.g. 2024,2025 |
yearFrom | integer | First year |
yearTo | integer | Last year |
period | string | e.g. YEAR, MARKETING YEAR, JAN, FIRST OF JAN, WEEK #30 |
frequency | string | ANNUAL, MONTHLY, WEEKLY or POINT IN TIME |
source | string: , SURVEY, CENSUS | Annual surveys or the Census of Agriculture Default: "". |
shortDesc | string | e.g. CORN, GRAIN - YIELD, MEASURED IN BU / ACRE |
unit | string | e.g. BU / ACRE, $ / BU, HEAD |
sector | string | CROPS, ANIMALS & PRODUCTS, ECONOMICS, DEMOGRAPHICS, ENVIRONMENTAL |
group | string | e.g. FIELD CROPS, VEGETABLES, FRUIT & TREE NUTS, LIVESTOCK, DAIRY |
domain | string | e.g. TOTAL, AREA OPERATED, ORGANIC STATUS |
extraFilters | string | Any Quick Stats parameter, e.g. {"class_desc": "WINTER"} |
listValuesOf | string: , commodity, statistic, unit, sector, group, class, utilPractice, domain, period, frequency, state | Return the valid values for one field instead of data Default: "". |
oldestFirst | boolean | Default is newest first Default: false. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/usda-nass-agriculture-statistics/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"commodity": "CORN", "statistic": "YIELD", "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.08 per 1,000 rows. No charge for errors or empty searches.
Related APIs
Argentina Central Bank API
Banco Central de la Republica Argentina data: catalog of 1,600+ monetary series with latest values, daily history for any series (reserves, policy rate, base money, inflation, peso exchange rates) and official FX quotes for every currency..
Australian Bureau of Statistics API: CPI, Jobs, GDP, Any Data API
Australian Bureau of Statistics data from the official ABS Data API: monthly CPI and trimmed mean, unemployment by state, GDP, wage price index and household spending presets, any ABS dataflow by SDMX key, and dataflow search.
Baltimore Distressed Property API
Baltimore City parcels from the city real property records joined to the tax lien certificate sale history: vacant building flag, estate or heir owner, absentee owner, deed age, repeat tax sales and a distress score..
Banco de Portugal API: Portugal Rates, Yields, HICP & GDP API
Banco de Portugal BPstat data from the official API: coincident indicators, HICP, GDP, house prices, confidence, Portuguese government bond yields, money-market, loan and deposit rates, banking ratios, or any BPstat dataset or series id..
Bank of Canada API: Policy Rate, CORRA, Bonds, CPI & CAD FX API
Bank of Canada statistics from its official Valet API: policy rate, CORRA, prime, T-bills, benchmark bond yields, mortgage and GIC rates, CPI and core CPI, commodity prices and daily CAD exchange rates.
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.
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