USDA National Farmers Market Directory Actor

Scrapes the USDA Local Food Portal farmers market export into structured records for directory enrichment, monitoring, and lead generation.

What it does

• Queries the USDA public download_by_directory export for one or more states, cities, zip/coordinate searches, or raw portal URLs.
• Normalizes the most useful market fields into a consistent dataset.
• Keeps the original source URL and query URL for traceability.

Important note

The actor uses the public export route and does not require an API key.

Use cases

1. Build a clean farmers market directory for analysis or enrichment.
2. Monitor market metadata across states, cities, or zip codes.
3. Export public market listings into CSV-ready JSON for downstream workflows.

Input

• directory: directory slug, default farmersmarket
• startUrls: optional USDA portal URLs
• states: state abbreviations to query
• cities: city/state lookups
• zipCodes: ZIP/radius lookups, with exact ZIP matching
• coordinates: x/y/radius lookups
• maxItems: maximum number of records to emit
• delaySeconds: pause between requests

Output fields

Field	Description
listing_id	USDA listing identifier
market_name	Farmers market name or listing title
address	Street address when present
city	City field from the source record
state	Two-letter state abbreviation
state_name	Full state or territory name when derived
zipcode	ZIP code
latitude	Latitude when available
longitude	Longitude when available
operating_times	Hours or operating schedule
products	Product offerings
market_setting	Market location/site details
indoor_status	Indoor/outdoor note
special_production_methods	USDA special production methods
payment_types	Accepted payment types
nutrition_programs	SNAP/WIC-style program fields when exposed
phone_order	Phone-order flag or note when exposed
contact_name	Public contact or manager name
manager_name	Manager name when separately exposed
phone	Public phone number
email	Public email address
website	Website or media website
update_date	Last update date
directory	Directory slug used for the query
source_url	Original API request URL
query_url	Canonical query URL used for the fetch

Pricing

Recommended at $4.99 per 1,000 results.

Example costs:

• 100 results: about $0.50
• 500 results: about $2.50
• 1,000 results: about $4.99
• 5,000 results: about $24.95

Example output

Live budget-capped test run with ACTOR_TEST_PAY_PER_EVENT=true ACTOR_MAX_TOTAL_CHARGE_USD=2:

[
  {
    "listing_id": "300002",
    "market_name": "Colorado Farm and Art Market",
    "address": "7350 Pine Creek Road, Colorado Springs, Colorado 80919",
    "city": "Colorado Springs",
    "state": "CO",
    "state_name": "COLORADO",
    "zipcode": "80919",
    "latitude": 38.937716,
    "longitude": -104.81468,
    "operating_times": null,
    "products": "Organic (USDA Certified)",
    "market_setting": "Private business parking lot;",
    "indoor_status": "No Indoor;",
    "special_production_methods": "Organic (USDA Certified)",
    "payment_types": "Debit card/Credit card",
    "nutrition_programs": "SNAP; Accept EBT at a central location",
    "phone_order": null,
    "contact_name": null,
    "manager_name": null,
    "phone": null,
    "email": null,
    "website": null,
    "update_date": "2020-08-03 13:44:04",
    "directory": "farmersmarket",
    "source_url": "https://www.usdalocalfoodportal.com/api/download_by_directory?directory=farmersmarket",
    "query_url": "https://www.usdalocalfoodportal.com/api/download_by_directory?directory=farmersmarket"
  },
  {
    "listing_id": "300003",
    "market_name": "Market in The Park",
    "address": "300 Conti, Mobile, Alabama 36602",
    "city": "Mobile",
    "state": "AL",
    "state_name": "ALABAMA",
    "zipcode": "36602",
    "latitude": 30.69035,
    "longitude": -88.045015,
    "operating_times": null,
    "products": "Organic (USDA Certified)",
    "market_setting": "Local government building grounds;",
    "indoor_status": "No Indoor;",
    "special_production_methods": "Organic (USDA Certified)",
    "payment_types": "Debit card/Credit card",
    "nutrition_programs": "Senior Farmers Market Nutrition Program",
    "phone_order": null,
    "contact_name": null,
    "manager_name": null,
    "phone": null,
    "email": null,
    "website": null,
    "update_date": "2020-08-03 09:33:29",
    "directory": "farmersmarket",
    "source_url": "https://www.usdalocalfoodportal.com/api/download_by_directory?directory=farmersmarket",
    "query_url": "https://www.usdalocalfoodportal.com/api/download_by_directory?directory=farmersmarket"
  }
]

Notes

• The AMS directory page links to the USDA Local Food Portal API docs.
• The public export currently returns 7,148 farmers market records.
• Output fields are normalized from the source JSON, with best-effort alias handling for public listing metadata.