USDA Agricultural Data Aggregator

Aggregate agricultural data from official USDA Quick Stats API with powerful analytics enrichment.

Pricing: Bring Your Own Key (BYOK) Model

Save money by using your own free API key!

Feature	Your Key (BYOK)	Our Managed Key
Get API Key	Free at USDA	Included
Per Query	$0.02 (10 free)	$0.10 (3 free)
Per Enriched Record	$0.01 (50 free)	$0.02 (20 free)

Example Costs

Scenario	BYOK Cost	Managed Cost
5 queries, 500 enriched records	$4.50	$9.10
10 queries, 1000 enriched records	$9.50	$19.60
20 queries, 5000 enriched records	$49.70	$99.40

Recommendation: Get your free API key in 2 minutes and save 50%+

---

Features

• Multiple Data Types: Crop prices, production, livestock, trade data
• Flexible Queries: Filter by commodity, state, year, aggregation level
• Analytics Enrichment: YoY changes, state rankings, trends, national comparisons
• Official Data Source: Direct from USDA National Agricultural Statistics Service

Data Available

Based on USDA Quick Stats parameters:

Dimension	Examples
WHAT (Commodity)	CORN, SOYBEANS, WHEAT, CATTLE, HOGS, MILK
WHERE (Location)	National, State, County, District, Zip Code
WHEN (Time)	Annual, Seasonal, Monthly, Weekly

Statistic Categories

• PRODUCTION, YIELD, AREA HARVESTED, AREA PLANTED
• PRICE RECEIVED, SALES, INVENTORY
• EXPORTS, IMPORTS

---

Quick Start

1. Get Your Free API Key (Recommended)

1. Go to https://quickstats.nass.usda.gov/api
2. Click "NASS Terms of Service" → Click "obtain an API key"
3. Enter email → Check inbox

2. Run the Actor

{
  "dataType": "Production",
  "commodity": "CORN",
  "state": "IA",
  "year": "2023",
  "useOwnApiKey": true,
  "usdaApiKey": "YOUR-API-KEY-HERE"
}

---

Example Inputs

Basic: Iowa Corn Production

{
  "dataType": "Production",
  "commodity": "CORN",
  "state": "IA",
  "year": "2023",
  "useOwnApiKey": true,
  "usdaApiKey": "YOUR-KEY"
}

Multi-Year with Enrichment

{
  "dataType": "Production",
  "commodity": "SOYBEANS",
  "state": "ALL",
  "year": "2019-2024",
  "enableEnrichment": true,
  "includeYearOverYear": true,
  "includeStateRankings": true,
  "includeTrendAnalysis": true,
  "useOwnApiKey": true,
  "usdaApiKey": "YOUR-KEY"
}

All Data Types for a Commodity

{
  "dataType": "All",
  "commodity": "WHEAT",
  "state": "KS",
  "year": "2023",
  "useOwnApiKey": true,
  "usdaApiKey": "YOUR-KEY"
}

---

Output Format

Basic Record

{
  "dataType": "Production",
  "commodity": "CORN",
  "state": "IA",
  "stateName": "IOWA",
  "year": 2023,
  "value": 2426400000,
  "unit": "BU",
  "statisticCategory": "PRODUCTION"
}

Enriched Record

{
  "dataType": "Production",
  "commodity": "CORN",
  "state": "IA",
  "year": 2023,
  "value": 2426400000,
  "unit": "BU",
  "yoyChange": 4.17,
  "yoyDirection": "increase",
  "stateRank": 1,
  "percentile": 100.0,
  "shareOfTotal": 15.8,
  "trend3Year": "moderate_growth",
  "trend3YearCAGR": 2.76,
  "vsNationalAverage": 455.6
}

---

Enrichment Features

Feature	Description
Year-over-Year	% change from previous year
State Rankings	Rank, percentile, share of total
Trend Analysis	3-year & 5-year CAGR
National Comparison	vs national average

---

Supported Commodities

Field Crops

CORN, SOYBEANS, WHEAT, COTTON, RICE, BARLEY, OATS, SORGHUM, HAY

Livestock

CATTLE, HOGS, SHEEP, CHICKENS, TURKEYS

Dairy

MILK

Other

HONEY, VEGETABLES, FRUITS, NUTS

---

API Limits

• Max 50,000 records per query (USDA limit)
• Use date ranges and state filters to stay under limit

---

Resources

• USDA Quick Stats
• Get Free API Key
• API Documentation

---

License

MIT License