Reference · built on requestCommons signalEconomic & calendar reference

USDA NASS Quick Stats

US crop and livestock survey and census statistics by county, state, and year from USDA NASS, with a free API key.

Request accessPricing ↗

About

Quick Stats is the National Agricultural Statistics Service's database of published estimates: hundreds of annual sample surveys and the Census of Agriculture, which runs every five years. The Quick Stats API at quickstats.nass.usda.gov/api returns the same records as JSON, XML, or CSV. You describe a query by WHAT (commodity, statistic, unit), WHERE (national, state, county, agricultural district, zip, watershed), and WHEN (year, period). Data files are updated following each week day.

On Fibric, an operator reads acreage, yield, production, or inventory figures for the commodities behind your supply and proposes a seasonal plan or a supplier check for your approval.

This is a reference listing. It documents what Fibric would read from USDA NASS Quick Stats and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • api_GET: records matching WHAT, WHERE, and WHEN parameters, up to 50,000 per request, as JSON, XML, or CSV
  • get_counts: the number of records a query would return, so you can split a large pull before running it
  • get_param_values: every valid value of a parameter such as sector_desc, commodity_desc, or statisticcat_desc
  • WHAT parameters: source_desc, sector_desc, group_desc, commodity_desc, class_desc, statisticcat_desc, unit_desc, short_desc, domain_desc
  • WHERE parameters: agg_level_desc, state_alpha, state_ansi, county_ansi, county_name, asd_code, region_desc, zip_5, watershed_code
  • WHEN parameters: year, freq_desc, begin_code, end_code, reference_period_desc, week_ending, with operators __LE, __GE, __LIKE, and __NE

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Plan a seasonal build on planted acreage

    Read the acreage and yield records for the commodities in your inputs at state level. The operator lines the series up with your seasonal plan and proposes a build quantity and timing for your approval.

    With Season Build, Demand Outlook

  • Check a supplier's growing region before committing

    Pull county-level production for a supplier's region across recent years. When the series trends down, the operator flags the supplier and proposes a second source for the buyer.

    With Supplier Fill Rate, Lead-Time Drift

  • Benchmark a site against its county

    For a farm or processing site, the operator pulls county and state series for the same commodity and unit and places the site's own figures beside them in the report.

    With Site Benchmark

Requirements

  • A Quick Stats API key, requested at quickstats.nass.usda.gov/api with a valid email address
  • Queries shaped so each api_GET call returns 50,000 records or fewer; run get_counts first
  • Parameter values spelled as NASS spells them, for example commodity_desc=CORN and state_alpha=VA
Authentication
A free API key. You request it with your name, organization, and email after agreeing to the NASS Terms of Service; the key arrives by email and goes in the key parameter of every call.

Limits

  • Each api_GET request returns at most 50,000 records; a larger query fails with "exceeds limit = 50000"
  • The API documents no per-series update time beyond the load_time field; NASS says its data files are updated following each week day
  • Survey and census estimates are periodic; this is not a daily price or market feed
  • Bulk history belongs to the compressed download files NASS publishes, not to repeated API pulls

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request USDA NASS Quick Stats ↗

Questions and answers

How do I get a Quick Stats API key?
Fill in the request form at quickstats.nass.usda.gov/api with your name or organization and a valid email address, after agreeing to the NASS Terms of Service. The key is emailed to you and must be included in every request.
What is the record limit per query?
50,000 records. NASS says a request over that returns the error "exceeds limit = 50000". Call get_counts with the same parameters first to see how many records a query would return, then narrow by year, state, or commodity.
Can I reuse the data?
NASS says most information on its site is within the public domain and asks that USDA-NASS be given appropriate acknowledgment in any subsequent use.
Ask about USDA NASS Quick Stats

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.

This Commons signal listing is developed, published, and supported by Fibric. It reads public data published by USDA National Agricultural Statistics Service (quickstats.nass.usda.gov). Upstream agencies and projects are the property of their respective owners, who are not affiliated with Fibric and do not sponsor or endorse this listing. Trademark policy