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.
| Name | Type | Description |
|---|---|---|
| productrequired | string | Product to search for — "raw milk", "eggs", "honey" |
| lat | number | Latitude of search center |
| lng | number | Longitude of search center |
| radius_miles | number | Search radius in miles (1–100, default 25) |
| state | string | US state abbreviation when no coordinates |
| certifications | string[] | Filter by certifications — ["organic"] |
| in_stock_only | boolean | Only return farms with in-stock listings |
| page | number | Page number (default 1) |
| per_page | number | Results per page (1–50, default 20) |
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"{
"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
}
]
}
]
}