harvestly 0.1.0

US farmers-market statistics: official Python client for the Harvestly Markets open dataset (CC BY 4.0, USDA-derived)

harvestly

Official Python client for the Harvestly Markets open dataset: state-by-state statistics on 8,800+ US farmers markets, ~2,000 CSA programs, and ~7,800 farm stands — cleaned, deduplicated, and enriched from the USDA AMS Local Food Portal.

• Data license: CC BY 4.0 (this client: MIT)
• Zero dependencies — Python ≥ 3.9 standard library only
• Data + methodology: harvestlymarkets.com/data-sources
• Human-readable reports: farmers-market statistics by state

Install

pip install harvestly

Python API

import harvestly

ds = harvestly.load()          # fetches once, then ~24h local cache

ds.national["farmers_markets"] # 8863
ds.state("vt")                 # {'state_name': 'Vermont', 'farmers_markets': ..., ...}
ds.state("California")         # abbreviation or full name

ds.top("website_pct", 5)                       # best online presence
ds.top("farmers_markets", 5, ascending=True)   # fewest markets

harvestly.state_url("ny")   # browse live listings for a state
harvestly.zip_url("12180")  # market finder for a ZIP

Each state row: farmers_markets, csa_programs, farm_stands, snap_ebt_markets, snap_ebt_pct, organic_vendor_markets, organic_pct, markets_with_website, website_pct.

CLI

harvestly national
harvestly state ca
harvestly top snap_ebt_pct -n 10
harvestly state vt --json     # machine-readable

Data notes

The dataset is rebuilt from the USDA substrate with documented cleaning: deduplication (the raw feed double-counts ~270 records), website/season/SNAP enrichment from live state sources, and per-state aggregation. Full methodology: harvestlymarkets.com/about/methodology. Archived copies: Zenodo (DOI 10.5281/zenodo.21247900), Hugging Face, Kaggle, GitHub.

Attribution (CC BY 4.0): Harvestly Markets (2026). US Farmers Market Statistics. https://harvestlymarkets.com/farmers-market-statistics/

Found a data issue? Every listing has a correction flow at harvestlymarkets.com/submit.