# HarvestPulse

> Farm-to-table intelligence API. Find local farms, decode food labels, track seasonal produce, and navigate the local food system — all via x402 micropayments on Base.

Base URL: https://harvestpulse.vercel.app
Payment: x402 protocol, USDC on Base mainnet, $0.05–$0.15 per query
Network: PulseNetwork (https://pulsenetwork.vercel.app)

---

## Endpoints

### GET /api/harvest/find — Local Farm & Market Finder ($0.05)
Find farmers markets, CSAs, and on-farm markets near a ZIP code via USDA Local Food Directories.
Params: zip (required), radius (default 25, miles)
Example: /api/harvest/find?zip=78701&radius=30

### GET /api/harvest/season — Seasonal Produce Calendar ($0.05)
What's in season right now by US state or country. Hardcoded calendar — no API key required.
Covers all US states + UK, AU, CA. Includes peak items, coming soon, and just-ended.
Params: state (2-letter US code) OR country (UK/AU/CA), month (1-12, defaults to current)
Example: /api/harvest/season?state=CA
Example: /api/harvest/season?country=UK&month=6

### GET /api/harvest/labels — Food Label Decoder ($0.08)
What food marketing labels actually mean legally vs. what they imply. Common labels:
natural, free-range, cage-free, pasture-raised, grass-fed, humanely-raised, hormone-free,
antibiotic-free, non-GMO, organic, biodynamic, fair-trade, wild-caught, sustainably-sourced
Params: label (required)
Example: /api/harvest/labels?label=free-range
Example: /api/harvest/labels?label=natural

### GET /api/harvest/organic — Certified Organic Farm Finder ($0.08)
Lookup USDA Organic INTEGRITY database for certified organic operations in a state/city.
Params: state (required, 2-letter code), city (optional)
Example: /api/harvest/organic?state=VT
Example: /api/harvest/organic?state=CA&city=Sonoma

### GET /api/harvest/dirty-dozen — Dirty Dozen & Clean Fifteen ($0.05)
EWG pesticide priority list — which produce to prioritize for organic purchasing.
Params: none required
Example: /api/harvest/dirty-dozen

### GET /api/harvest/food-hub — Regional Food Hub Finder ($0.08)
Find food hubs (farm aggregators) connecting local farms to restaurants, schools, and institutions.
Params: zip (optional), radius (default 75, miles)
Example: /api/harvest/food-hub?zip=97201&radius=100

### GET /api/harvest/regenerative — Regenerative Agriculture Guide ($0.10)
Explains regenerative agriculture certification tiers (ROC, CNG, Land to Market), how to find farms,
and questions to ask. The next wave beyond organic.
Params: query (optional search terms), state (optional)
Example: /api/harvest/regenerative?state=VT
Example: /api/harvest/regenerative?query=beef+regenerative

### GET /api/harvest/designations — Global Food Designations ($0.10)
EU PDO/PGI, French AOC/AOP, Italian DOP/IGP — what protected origin labels mean, how to identify
authentic vs. imitation products (Parmigiano Reggiano vs. Parmesan, Champagne vs. sparkling wine, etc.)
Params: product (required)
Example: /api/harvest/designations?product=parmigiano-reggiano
Example: /api/harvest/designations?product=champagne
Example: /api/harvest/designations?product=prosciutto-di-parma

### GET /api/harvest/agritourism — Farm Experiences & U-Pick Finder ($0.05)
Find agritourism operations: u-pick farms, farm stays, harvest festivals, farm-to-table dinners.
Params: zip (optional), state (optional), radius (default 50, miles)
Example: /api/harvest/agritourism?zip=28801&radius=40
Example: /api/harvest/agritourism?state=VT

### GET /api/harvest/csa — CSA Evaluation Guide ($0.10)
How to choose, join, and maximize a Community Supported Agriculture share. Types, costs,
questions to ask, and strategies for using everything in the box.
Params: location (city/state or region), household_size (default 2)
Example: /api/harvest/csa?location=Austin+TX&household_size=3

### GET /api/harvest/cost — Local vs. Conventional Cost Analysis ($0.10)
Real cost comparison of local/organic vs. conventional grocery shopping.
Uses FRED food CPI data for macro context.
Params: items (comma-separated produce), location (optional)
Example: /api/harvest/cost?items=strawberries,tomatoes,lettuce&location=Northeast

### GET /api/harvest/roadmap — Farm-to-Table Lifestyle Roadmap ($0.15)
Phased 3-month transition guide to eating more locally and seasonally. Budget-aware and practical.
Params: location (city or region), weekly_budget (dollars, default 150), goals (optional text)
Example: /api/harvest/roadmap?location=Chicago+IL&weekly_budget=200&goals=reduce+pesticides

---

## Payment
All endpoints require x402 payment header (PAYMENT-SIGNATURE).
On 402 response, read PAYMENT-REQUIRED header for payment details.
USDC on Base mainnet (eip155:8453).
Wallet: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Data Sources
- USDA Local Food Portal API (farmersmarket, CSA, onfarm, foodhub, agritourism directories)
- USDA Organic INTEGRITY Database (certified organic operations, no auth required)
- FRED Federal Reserve (food CPI indices)
- HarvestPulse Seasonal Calendar (hardcoded, all 50 states + UK/AU/CA — no API key required)
- Tavily AI web search (real-time context)
- Claude (synthesis and intelligence layer)

## Network
Part of PulseNetwork — 36 specialized intelligence APIs.
https://pulsenetwork.vercel.app