Skip to main content

​
GET /v1/market/landscape

Returns raw market landscape data for a geographic area. Includes farm counts, quality score distribution, product/certification/practice/delivery breakdowns with counts and percentages, distance distribution, verification status, and pricing coverage. Optionally filter to a single product to get the landscape for that product only.

​
Query parameters

​
lat
number
required
Latitude of the search center.
​
lng
number
required
Longitude of the search center.
​
radius
number
default:"25"
Search radius in miles. Accepted range: 1–100.
​
product
string
Optional product filter. When set, only farms carrying this product are included in the landscape.

​
Example request

curl "https://api.bhumifarms.co/v1/market/landscape?lat=45.52&lng=-122.68&radius=25" \
  -H "X-API-Key: bh_live_your_key_here"

​
Example response

{
  "location": { "lat": 45.52, "lng": -122.68 },
  "radius_miles": 25,
  "product_filter": null,
  "total_farms": 47,
  "quality": {
    "avg_score": 72,
    "median_score": 78,
    "min_score": 12,
    "max_score": 97,
    "tiers": {
      "premium": 18,
      "standard": 20,
      "basic": 7,
      "incomplete": 2
    }
  },
  "distance_distribution": {
    "within_5mi": 8,
    "within_10mi": 15,
    "within_25mi": 22,
    "beyond_25mi": 2
  },
  "place_types": {
    "farm": 35,
    "farmers_market": 8,
    "csa": 4
  },
  "products": [
    { "name": "pastured eggs", "count": 28, "pct": 59.6 },
    { "name": "raw milk", "count": 12, "pct": 25.5 },
    { "name": "honey", "count": 10, "pct": 21.3 }
  ],
  "certifications": [
    { "name": "USDA Organic", "count": 9, "pct": 19.1 }
  ],
  "practices": [
    { "name": "grass-fed", "count": 22, "pct": 46.8 },
    { "name": "pasture-raised", "count": 18, "pct": 38.3 }
  ],
  "delivery_options": [
    { "name": "farm pickup", "count": 38, "pct": 80.9 },
    { "name": "local delivery", "count": 12, "pct": 25.5 }
  ],
  "verification": {
    "self_reported": 30,
    "verified": 12,
    "unverified": 5
  },
  "pricing": {
    "farms_with_structured_prices": 14,
    "pct_with_prices": 29.8
  }
}

​
Response fields

​
total_farms
number
Total number of farms in the search area.
​
quality
object
Quality score distribution across all farms in the area.
​
products
object[]
Top 30 products by farm count. Each entry has name, count, and pct (percentage of farms carrying the product).
​
certifications
object[]
All certifications with name, count, and pct.
​
practices
object[]
Top 20 farming practices with name, count, and pct.
​
pricing
object
How many farms have structured product pricing in the database.