BuyersMarket Data API — Grocery Price Intelligence for Jamaica

Simple Integration

Start fetching data in minutes

One API key. REST endpoints. Standard JSON responses. Query prices by product, store, category, or date range. No setup beyond your first request.

✓ Bearer token authentication via X-API-Key header
✓ Paginated results with cursor support
✓ ISO 8601 timestamps, JMD pricing
✓ Rate limits returned in response headers

curl https://data.buyersmarket.app/v1/prices \
  -H "X-API-Key: bm_your_key_here" \
  -G \
  --data-urlencode "category=Dairy" \
  --data-urlencode "limit=10"

import httpx

client = httpx.Client(
    base_url="https://data.buyersmarket.app",
    headers={"X-API-Key": "bm_your_key_here"}
)

resp = client.get("/v1/prices", params={
    "category": "Dairy",
    "limit": 10,
})
prices = resp.json()["data"]
for p in prices:
    print(p["product_name"], p["price_jmd"])

const res = await fetch(
  "https://data.buyersmarket.app/v1/prices?category=Dairy&limit=10",
  { headers: { "X-API-Key": "bm_your_key_here" } }
);
const { data } = await res.json();
data.forEach(p => console.log(p.product_name, p.price_jmd));

Sample response

{
  "data": [
    {
      "product_name": "Grace Whole Milk 1L",
      "category": "Dairy",
      "price_jmd": 425.00,
      "store": "Hi-Lo Food Stores",
      "rating": "A",
      "scraped_at": "2026-03-03T06:14:00Z"
    }
  ],
  "total": 847,
  "page": 1
}

What's in the API

Everything you need to understand Jamaican grocery prices

🏷️

Current Prices

Live price data from Hi-Lo, MegaMart, PriceSmart, Sampars, Loshusan, MasterMac, and more. Filtered by product, store, category, or brand.

→ /v1/prices

🛒

Product Catalog

18,000+ standardised grocery products with barcodes, brands, categories, and unit sizes. Search by keyword, barcode, or category.

→ /v1/products

🏪

Stores & Chains

31 store locations across Jamaica with GPS coordinates and chain affiliation. Filter prices by store or parish.

→ /v1/stores

📈

Price Trends

30, 60, and 90-day price history for any product or category. Track inflation trajectories, identify seasonal patterns, and benchmark against baselines.

→ /v1/trends

📊

BGPI — Grocery Price Index

The BuyersMarket Grocery Price Index: a composite measure of the cost of a standard basket of Jamaican staples. Updated daily.

→ /v1/market/bgpi

🎯

A-B-C Price Ratings

A = at or below 90-day low (grab it). B = within 10% of low (fair). C = more than 10% above low (hold off).

→ Rating schema

Use Cases

Built for those who study and protect consumers

🏛️

Government & Policy

Monitor food price inflation, evaluate consumer protection policies, and track CAC baseline compliance across Jamaican retailers. Build evidence for intervention.

🔬

Academic Research

Longitudinal price datasets for economics and nutrition studies. Track the cost of a healthy diet, study price elasticity, or compare grocery inflation to wages.

🤝

NGOs & Social Impact

Measure food affordability for low-income households. Quantify the real cost of nutritious eating and build data-driven advocacy reports.

📱

App Developers

Embed Jamaican grocery pricing into your application. Build shopping assistants, household budget tools, or fintech products that understand real food costs.

Access Tiers

Start free. Scale as you grow.

All tiers include full data access. Limits apply to API call volume.

Research

Free

for academic & NGO use

✓ 1,000 requests / month
✓ Full data access
✓ All endpoints
✓ Email support

Apply for Access

Ready to explore Jamaican grocery data?

Get your API key in under a minute. Free for research and NGO use.

Get Started →