GET /v1/search
Search for farms by location, products, certifications, and practices. Returns farm profiles sorted by distance with quality tiers and product lists.
| Name | Type | Description |
|---|---|---|
| lat | number | Latitude of search center |
| lng | number | Longitude of search center |
| radius_miles | number | Search radius in miles (1–100, default 25) |
| query | string | Free-text search across farm names and descriptions |
| products | string[] | Filter by products — ["dairy", "eggs", "honey"] |
| categories | string[] | Filter by category — ["raw dairy", "pasture-raised meats"] |
| certifications | string[] | Filter by certifications — ["organic", "non-gmo"] |
| state | string | US state abbreviation when no coordinates |
| page | number | Page number (default 1) |
| per_page | number | Results per page (1–50, default 20) |
curl "https://api.bhumifarms.co/v1/search\
?lat=45.52&lng=-122.68&radius_miles=30\
&products=dairy&certifications=organic" \
-H "X-API-Key: bh_live_your_key"{
"count": 12,
"page": 1,
"per_page": 20,
"farms": [
{
"id": "f8a1c2d3-4e5f-6789-abcd-ef0123456789",
"name": "Headwater Hills Creamery",
"city": "McMinnville",
"state": "OR",
"distance_mi": 12.4,
"quality_tier": "Premium",
"products": ["raw milk", "cheese", "butter", "yogurt"],
"certifications": ["Certified Organic", "Animal Welfare Approved"],
"practices": ["grass-fed", "pasture-raised", "no antibiotics"]
},
{
"id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
"name": "Willamette Valley Dairy",
"city": "Salem",
"state": "OR",
"distance_mi": 24.1,
"quality_tier": "Standard",
"products": ["raw milk", "cream", "kefir"],
"certifications": ["Organic"],
"practices": ["grass-fed", "hormone-free"]
}
]
}