Public read API
Base URL: https://farm-to-door.com/api. All endpoints below are public, read-only, and require no auth or API key. Responses are JSON.
- GET /farms/summary
- Farm records in a bounding box or radius. Params: origin_lat, origin_lng, radius_miles, north, south, east, west, limit.
- GET /farms/pins
- Lightweight map pins (id, name, tier, coords) for the same geo params as /farms/summary.
- GET /farms/nearby
- Nearest farms to a point. Params: lat, lng, limit.
- GET /farms/count
- Directory totals: total, prerender_eligible, estimated.
- GET /farms/{farm_id}
- A single farm record by id.
- GET /categories
- Product and category filter list.
- GET /practices
- Farming practice filter list: organic, regenerative, and so on.
- GET /specialties
- Specialty product filter list.
- GET /attributes
- Farm attribute filter list.
- GET /states
- US states with listed farms.
- GET /seasonal
- Seasonal crop and product data.
Example: nearest farms to a point.
curl "https://farm-to-door.com/api/farms/nearby?lat=40.7128&lng=-74.0060&limit=5"OpenAPI spec and interactive docs
The full, authoritative parameter and response reference is the OpenAPI spec at farm-to-door.com/api/openapi.json. It is generated from the live API, not hand-maintained, so it never drifts from what the API actually returns.
For interactive testing, use the Swagger UI at farm-to-door.com/api/docs.
Bulk data, the polite way
Please do not bulk-crawl the live API. These static resources carry the same data and are built for retrieval:
- summary.json and summary.csv. Counts by state, city, category, and delivery capability.
- sitemap.xml. Every indexable farm profile and content page, chunked. Farm-profile lastmod is included only when a defensible event-backed page date exists.
- Farm profile pages at
/farms/[state-slug]/[city-slug]/[farm-name-id]. Static HTML with schema.org LocalBusiness and Farm JSON-LD.
Official SDK
An official JS/TS client ships as the farm-to-door npm package.
npm install farm-to-doorSource: github.com/Potarix/farm-to-door-sdk. The repo also carries AGENTS.md and SKILL.md for AI coding agents wiring up farm-to-door directly.
For AI agents
Read llms.txt first: a machine-readable summary of the site, key pages, and this API. robots.txt welcomes AI crawlers (GPTBot, ClaudeBot, PerplexityBot, and more). Farm profile pages carry LocalBusiness and Farm JSON-LD, so structured facts are available without parsing prose.
Contact
Questions, rate limits, or partnership requests: omar@farm-to-door.com.