Skip to main content
Choose the path that matches how you’re using Bhumi.

​
Developer Quick Start

Make your first API request in 3 minutes.
1

Get an API key

Sign up at console.bhumifarms.co to create a free API key. Your key looks like bh_live_abc123....Free tier includes 1,000 requests/day with no credit card required.
2

Make your first request

Search for farms near any location using latitude, longitude, and a radius.
curl "https://api.bhumifarms.co/v1/search?lat=33.08&lng=-96.54&radius=25" \
  -H "X-API-Key: bh_live_your_key_here"
3

Read the response

The API returns a data array of farm objects and a meta pagination object.
{
  "data": [
    {
      "id": "farm_abc123",
      "name": "Prairie Farmstead",
      "city": "Sherman",
      "state": "TX",
      "lat": 33.635,
      "lng": -96.609,
      "products": ["grass-fed beef", "pastured eggs"],
      "certifications": ["USDA Organic"],
      "quality_score": 87,
      "place_type": "farm",
      "distance_mi": 12.4
    }
  ],
  "meta": {
    "count": 20,
    "page": 1,
    "per_page": 20,
    "has_more": true
  }
}
See the full Developer Guide and API Reference for all available endpoints, filters, and response fields.