Skip to main content
Products in the Bhumi API are represented at two levels: a lightweight products array available on all farm objects, and a richer product_listings array available on the paid tier when fetching a single farm profile.

​
Products array

Every farm object returned by /v1/farms and /v1/search includes a products field — a flat array of product name strings representing what the farm currently offers. 
{
  "id": "farm_abc123",
  "name": "Prairie Farmstead",
  "products": ["grass-fed beef", "pastured eggs", "bacon", "lard"],
  "categories": ["meat", "eggs"]
}
You can use this array directly to display what a farm carries, or pass values from it back into the products filter parameter on /v1/search and /v1/farms to find other farms carrying the same item.

​
Products as filters

The products query parameter on /v1/search and /v1/farms accepts comma-separated values and performs an overlap match — farms that carry any of the listed products are returned. 
GET /v1/search?lat=33.08&lng=-96.54&products=raw milk,aged cheddar
Matching is case-insensitive.

​
Categories array

The categories field groups products into broader types. A farm with products: ["grass-fed beef", "pastured pork"] will typically have categories: ["meat"]. Common categories across the platform:
CategoryExample products
meatgrass-fed beef, pastured pork, lamb, bison
poultrypastured chicken, heritage turkey, duck
eggspastured eggs, duck eggs, quail eggs
dairyraw milk, aged cheddar, yogurt, butter, kefir
vegetablestomatoes, sweet corn, leafy greens, root vegetables
fruitapples, peaches, berries, melons
grainswheat berries, cornmeal, heirloom grains
honeyraw honey, comb honey, infused honey
herbsculinary herbs, medicinal herbs, dried herbs
flowerscut flowers, dried arrangements
value-addedjams, sauces, pickles, baked goods
Filter by categories when you want broader results (any farm selling dairy), and by products when you want something specific (only farms with raw milk).

​
Product listings (paid tier)

On the paid tier, GET /v1/farms/:id returns a product_listings array nested inside the farm object. Each entry is a structured record with pricing, unit, stock status, and category. 
{
  "data": {
    "id": "farm_abc123",
    "name": "Prairie Farmstead",
    "product_listings": [
      {
        "id": "prod_001",
        "name": "Grass-Fed Ground Beef",
        "price": 9.50,
        "unit": "lb",
        "category": "meat",
        "in_stock": true
      },
      {
        "id": "prod_002",
        "name": "Pastured Eggs",
        "price": 7.00,
        "unit": "dozen",
        "category": "eggs",
        "in_stock": true
      },
      {
        "id": "prod_003",
        "name": "Beef Tallow",
        "price": 12.00,
        "unit": "quart",
        "category": "value-added",
        "in_stock": false
      }
    ]
  }
}

​
Product listing fields

​
id
string
Unique identifier for this product listing.
​
name
string
Product name as listed by the farm.
​
price
number
Price in US dollars. Represents the cost for one unit.
​
unit
string
Unit of measure. Common values: lb, oz, kg, each, dozen, quart, gallon, pint, bunch, bag, package.
​
category
string
Product category. Matches the same category vocabulary used in the categories array on the farm object.
​
in_stock
boolean
Whether this product is currently available for purchase or pickup. false does not mean the product is permanently discontinued — availability may be seasonal or depend on harvest timing.
Product listings are only available on the single-farm endpoint (GET /v1/farms/:id) with a paid tier key. They are not included in list or search responses.

​
Place types

Farms are classified by place_type, which indicates the nature of the operation. The following place types appear across the platform:
ValueDescription
farmTraditional farm operation with direct sales.
ranchPrimarily livestock and pasture-based operation.
marketFarmers market or farm stand with multiple vendors.
csaCommunity Supported Agriculture subscription operation.
orchardTree fruit or nut production.
greenhouseIndoor or protected cultivation.
apiaryHoney and bee product producer.
aquacultureFish, shellfish, or aquatic product producer.
You can filter by place_type on /v1/farms to narrow results to a specific operation type.