find_food

GET /v1/food

Product-first search. Instead of searching for farms and checking what they carry, start with the product and get farms that have it — with pricing, stock status, and distance.

Parameters

NameTypeDescription
productrequiredstringProduct to search for — "raw milk", "eggs", "honey"
latnumberLatitude of search center
lngnumberLongitude of search center
radius_milesnumberSearch radius in miles (1–100, default 25)
statestringUS state abbreviation when no coordinates
certificationsstring[]Filter by certifications — ["organic"]
in_stock_onlybooleanOnly return farms with in-stock listings
pagenumberPage number (default 1)
per_pagenumberResults per page (1–50, default 20)

Example request

curl "https://api.bhumifarms.co/v1/food\
  ?product=raw+milk&lat=45.52&lng=-122.68\
  &radius_miles=25&in_stock_only=true" \
  -H "X-API-Key: bh_live_your_key"

Example response

{
  "product_searched": "raw milk",
  "count": 8,
  "farms": [
    {
      "name": "Headwater Hills",
      "city": "McMinnville",
      "state": "OR",
      "distance_mi": 12.4,
      "quality_tier": "Premium",
      "matching_products": [
        {
          "name": "Raw Goat Milk",
          "price": 8.00,
          "unit": "half gallon",
          "in_stock": true
        }
      ]
    },
    {
      "name": "Prairieland Creamery",
      "city": "Sherwood",
      "state": "OR",
      "distance_mi": 18.2,
      "matching_products": [
        {
          "name": "Raw Cow Milk",
          "price": 12.00,
          "unit": "gallon",
          "in_stock": true
        }
      ]
    }
  ]
}