Usda Nass
agriculture__usda-nassRead-onlyIdempotent
Query USDA NASS agricultural statistics for crops and livestock by commodity, year, and state to access production, yield, and price data with quality scoring and source verification.
Instructions
[Agriculture & Food Agent] Query the USDA National Agricultural Statistics Service (NASS) Quick Stats API for crop and livestock statistics by commodity, year, and state. Source: USDA NASS (Public Domain (U.S. Government)), updates monthly. Returns the Katzilla envelope { data, quality, citation } — quality scores freshness/uptime/confidence; citation carries the source URL, license, and a SHA-256 data hash for audit.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| commodity | No | Commodity description (e.g. CORN, SOYBEANS, WHEAT) | |
| statisticCategory | No | Statistic category (e.g. PRODUCTION, AREA HARVESTED, YIELD, PRICE RECEIVED) | |
| state | No | State alpha code (e.g. IA, IL, TX). Omit for national totals. | |
| commodity_desc | No | Commodity description using USDA field name (e.g. CORN, SOYBEANS, WHEAT) | |
| statisticcat_desc | No | Statistic category using USDA field name (e.g. PRODUCTION, AREA HARVESTED) | |
| state_alpha | No | State alpha code using USDA field name (e.g. IA, IL, TX) | |
| year | No | Statistics year (USDA NASS data lags ~1 year) | |
| aggLevel | No | Aggregation level: NATIONAL, STATE, COUNTY, or REGION | NATIONAL |
| agg_level_desc | No | Aggregation level using USDA field name | |
| limit | No | Maximum rows to return |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | Structured payload from the upstream source. | |
| text | No | Pre-rendered text representation, when applicable. | |
| quality | Yes | Quality scorecard: freshness, uptime, completeness, confidence, certainty. | |
| citation | Yes | Provenance block — source, license, retrieval timestamp, SHA-256 data hash, pre-formatted citation text. |