Developers

The SA Grocery Price API

Real shelf prices from South Africa’s big supermarkets, in clean JSON. Not a survey — the same data behind LoyaltyHub, refreshed twice a week.

Real prices

Woolworths, Checkers, Shoprite, Pick n Pay, Clicks and Makro — tens of thousands of products.

Freshness built in

Every response tells you exactly when the data was last updated.

Simple auth

One API key. Bearer token or x-api-key header. JSON everywhere.

Quickstart

Create a key below, then:

curl https://loyaltyhub.co.za/api/v1/prices?search=milk \
  -H "Authorization: Bearer lh_live_your_key_here"

Endpoints

GET /api/v1/retailersRetailers we track, each with its last-updated time.

GET /api/v1/indexMonthly SA Grocery Price Index (aggregated).

GET /api/v1/prices?search=milkCurrent prices. Filter by barcode, retailer, category or search.

GET /api/v1/products?barcode=6001240100014One product, grouped across every retailer.

GET /api/v1/history?barcode=6001240100014Price history for a product.

Every response includes an updated_at timestamp and your remaining monthly quota.

Pricing

Intro pricing while we’re in beta. Cancel anytime.

Free

1 000 calls / month

Starter

R199/mo

50 000 calls / month

Business

R499/mo

500 000 calls / month

Your keys

Data is provided as-is for informational use. Prices are collected from public retailer sites and may lag real shelf prices. Get in touch for bulk or enterprise access.