Nass Query
nass_querySearch USDA agricultural statistics by commodity, statistic, geography, and year. Returns production, yield, acreage, prices, and livestock data (e.g., commodity="CORN", state_fips="06" for California).
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"year": "2024",
"state": "IOWA",
"commodity": "CORN",
"stat_category": "YIELD"
},
"name": "nass_query"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| freq | No | Frequency: "ANNUAL", "MONTHLY", or "WEEKLY" (optional) | |
| year | No | Year or range, e.g., "2024" or "2020:2025" (optional) | |
| group | No | Commodity group, e.g., "FIELD CROPS", "FRUIT & TREE NUTS", "VEGETABLES" (optional) | |
| state | No | State name, e.g., "IOWA", "ILLINOIS", "CALIFORNIA" (optional) | |
| sector | No | Sector: "CROPS", "ANIMALS & PRODUCTS", "ECONOMICS", "DEMOGRAPHICS", "ENVIRONMENTAL" (optional) | |
| source | No | Data source: "SURVEY" or "CENSUS" (optional, defaults to all) | |
| _apiKey | Yes | NASS API key (free from quickstats.nass.usda.gov/api) | |
| agg_level | No | Aggregation level: "NATIONAL", "STATE", or "COUNTY" (optional) | |
| commodity | Yes | Commodity name, e.g., "CORN", "SOYBEANS", "WHEAT", "CATTLE", "MILK", "COTTON" | |
| stat_category | No | Statistic category, e.g., "YIELD", "PRODUCTION", "AREA PLANTED", "AREA HARVESTED", "PRICE RECEIVED", "INVENTORY" |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | Array of up to 200 agricultural records | |
| count | Yes | Number of records returned | |
| truncated | Yes | True if results exceed 200 records and were truncated |