Shoprite
South African grocery prices from shoprite.co.za (Shoprite Sixty60): price in rand, Xtra Savings card price, multi-buys, stock on hand and product facts per delivery address.
/shoprite/v1/search1 creditSearch the Shoprite shop (shoprite.co.za, South Africa) for one delivery address or its default store: shelf price in rand (ZAR), Xtra Savings card price kept apart from the price, Xtra Savings multi-buy ("Buy 3 For R17"), price per kg for goods sold by weight, stock on hand, brand and barcode per product. `query` or `category_id` is required (either one); `barcode` finds one product by its EAN.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | What to search for, as typed in the site's search box. Search is fuzzy: a nonsense word still returns loose matches. Required unless category_id or barcode is given. |
| category_id | optional | — | Category id from the `categories` action. Without a query any level works; together with a query only a top-level department narrows the search. |
| barcode | optional | — | Find the product with this barcode (EAN, 8-14 digits). |
| latitude | optional | — | Delivery address latitude (with longitude). Prices, stock and the assortment are those of the Shoprite Sixty60 store that delivers there (e.g. Johannesburg CBD -26.2041, 28.0473). Where Checkers Sixty60 delivers instead (most of Cape Town, Sandton, Durban, Pretoria) the answer is NOT_FOUND naming checkers.co.za. Without an address the Shoprite shop's own default store is used and the answer says so (store_defaulted: true). |
| longitude | optional | — | Delivery address longitude (with latitude). |
| page = 1 | optional | 1–500 | Page number, from 1. Past the last page the answer is an empty page. |
| page_size = 24 | optional | 1–100 | Products per page, 1-100 (default 24, the site's own page). A larger page means fewer calls to walk a whole category. |
| sort = relevance | optional | relevance · best_sellers · price_asc · price_desc · name_asc · name_desc | Order of the results. Default: best match with a query, name A-Z without one — in both, walking page 1, 2, 3 … returns every product of the list exactly once (the site's own unsorted category listing repeats some products across pages and skips others, so the engine never asks for it). Price and best-seller order are the site's own and have ties: across pages they can repeat or skip products — to collect a whole list, walk it in the default order and sort it yourself. |
| brand | optional | — | Only this brand, written exactly as the `brand` field of a row (case-sensitive: Clover, not clover). |
| on_promotion = false | optional | — | Only products on a deal (sale price or Xtra Savings offer). |
/shoprite/v1/promotions1 creditOnly the Shoprite products on a deal for one delivery address (or the default store) — sale prices and Xtra Savings offers (card price, multi-buys) — inside a search term or a category (one of the two is required).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Deals whose product matches this search (or give category_id). |
| category_id | optional | — | Category id from the `categories` action. Without a query any level works; together with a query only a top-level department narrows the search. |
| latitude | optional | — | Delivery address latitude (with longitude). Prices, stock and the assortment are those of the Shoprite Sixty60 store that delivers there (e.g. Johannesburg CBD -26.2041, 28.0473). Where Checkers Sixty60 delivers instead (most of Cape Town, Sandton, Durban, Pretoria) the answer is NOT_FOUND naming checkers.co.za. Without an address the Shoprite shop's own default store is used and the answer says so (store_defaulted: true). |
| longitude | optional | — | Delivery address longitude (with latitude). |
| page = 1 | optional | 1–500 | Page number, from 1. Past the last page the answer is an empty page. |
| page_size = 24 | optional | 1–100 | Products per page, 1-100 (default 24, the site's own page). A larger page means fewer calls to walk a whole category. |
| sort = relevance | optional | relevance · best_sellers · price_asc · price_desc · name_asc · name_desc | Order of the results. Default: best match with a query, name A-Z without one — in both, walking page 1, 2, 3 … returns every product of the list exactly once (the site's own unsorted category listing repeats some products across pages and skips others, so the engine never asks for it). Price and best-seller order are the site's own and have ties: across pages they can repeat or skip products — to collect a whole list, walk it in the default order and sort it yourself. |
| brand | optional | — | Only this brand, written exactly as the `brand` field of a row (case-sensitive: Clover, not clover). |
/shoprite/v1/product2 creditsOne Shoprite product by the `product_id` a search row returns (article number + unit, e.g. 10136729EA) or a shoprite.co.za product URL: price, Xtra Savings price and every offer with dates, price per kg and weight range, stock on hand, barcodes, brand, description, attributes (ingredients, allergens, nutrition, halaal / kosher as the site prints them), categories, images.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | — | The `product_id` exactly as a search row returns it (article number + unit: 10387741EA, 10156094PK1, 10796287KG) or a product URL ending in it. |
| latitude | optional | — | Delivery address latitude (with longitude). Prices, stock and the assortment are those of the Shoprite Sixty60 store that delivers there (e.g. Johannesburg CBD -26.2041, 28.0473). Where Checkers Sixty60 delivers instead (most of Cape Town, Sandton, Durban, Pretoria) the answer is NOT_FOUND naming checkers.co.za. Without an address the Shoprite shop's own default store is used and the answer says so (store_defaulted: true). |
| longitude | optional | — | Delivery address longitude (with latitude). |
/shoprite/v1/categories2 creditsThe Shoprite shop's category tree (33 departments, 813 categories on 2026-11-22) with the ids `search` takes as category_id; or one department's subtree.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category_id | optional | — | A top-level department id: only its subtree. |
/shoprite/v1/stores2 creditsPhysical stores of the Shoprite group near a point (Shoprite, Shoprite LiquorShop, Shoprite Mini, Checkers, Checkers Hyper, Petshop Science …): name, brand, address, coordinates, distance, opening hours per day. The same group directory as on checkers.co.za.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| latitude | required | — | Latitude of the point to search around. |
| longitude | required | — | Longitude of the point. |
| radius_km = 20 | optional | 1–300 | Search radius in km (1-300, default 20). |
| limit = 12 | optional | 1–200 | At most this many stores, nearest first (1-200, default 12). |
| brand | optional | — | Keep only stores whose brand starts with this text (case-insensitive): Shoprite (also Shoprite LiquorShop, Shoprite Mini), Checkers, Petshop Science …, applied to the nearest `limit` stores. |
curl -X POST https://api.reefapi.com/shoprite/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"milk","latitude":-26.2041,"longitude":28.0473}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.