Every Makro South Africa price, deal and seller, with Cape Town's own prices by postal code
The Makro API returns makro.co.za, the online shop of Makro South Africa, as JSON: for every product the price in rand, the was-price and discount, Makro's More4Less multi-buy deals ("Buy any 3 at R 50.00" on a R24.95 sponge wipe), stock state, whether Makro or a marketplace seller sells it, brand, pack size, rating, images and the product URL.
- fields per product
- 26
- endpoints
- 8
- credits per call
- 1–3
2 credits per call≈ $2/1,000 calls1,000 free credits, no card
- Clover Full Cream Long Life Milk, Plain Flavour94.95 ZAR
- rank
- 1
- brand
- Clover
- Clover Nolac Lactose Free Medium Fat, Milk Flavour109.95 ZAR
- rank
- 2
- brand
- Clover
- Clover Ultra Uht Full Cream Milk94.95 ZAR
- rank
- 3
- brand
- Clover
8 active endpoints, on 1, 2 and 3 credit tiers.
- POST/makro/v1/search2 credits
- POST/makro/v1/category2 credits
- POST/makro/v1/categories2 credits
- POST/makro/v1/product2 credits
- POST/makro/v1/products3 credits
- POST/makro/v1/offers1 credit
- POST/makro/v1/promotions2 credits
- POST/makro/v1/stores1 credit
Run the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
Makro API
5 of 8 endpoints, ready to run
Search Makro: price in rand, was-price and discount, stock, seller, brand and pack size per product, with the site's total and page count.
{ "ok": true, "meta": { "api": "makro", "endpoint": "search", "mode": "live", "latency_ms": 1184, "record_count": 40, "cache_hit": false }, "data": { "query": "clover milk", "category_id": null, "sort": "relevance", "filters": {}, "postal_code": "2157", "postal_code_defaulted": true, "total": 214, "page": 1, "page_size": 40, "total_pages": 6, "reachable_pages": 6, "complete_walk_possible": true, "returned": 40, "products": [ { "rank": 1, "product_id": "MLKHFXJTMV3AMYRY", "item_id": "ITMA7F0B28C4E120", "listing_id": "LSTMLKHFXJTMV3AMYRYY4BBGJ", "title": "Clover Full Cream Long Life Milk, Plain Flavour", "brand": "Clover", "pack_size": "6 x 1 L", "price": 94.95, "currency": "ZAR", "original_price": 109.95, "savings": 15, "discount_percent": 13, "price_per_unit": null, "in_stock": true, "availability": "IN_STOCK", "seller_id": "155410923f68483e", "sold_by_makro": true, "rating": 4.7, "rating_count": 2898, "review_count": 82, "key_specs": [ "Container Type: Tetra Pack", "Flavour: Plain", "Quantity: 1 L" ], "category": { "super": "Perishables", "sub": "Dairy Milk", "leaf": "milk" }, "image": "https://www.makro.co.za/asset/rukmini/fccp/832/832/ng-fkpublic-ui-user-fbbe/milk/c/f/n/-original-imahsgg9uvfwhmt3.jpeg?q=70", "images": [ "https://www.makro.co.za/asset/rukmini/fccp/832/832/ng-fkpublic-ui-user-fbbe/milk/c/f/n/-original-imahsgg9uvfwhmt3.jpeg?q=70", "https://www.makro.co.za/asset/rukmini/fccp/832/832/ng-fkpublic-ui-user-fbbe/milk/x/u/p/-original-imahsgg9hgzgdhud.jpeg?q=70" ], "url": "https://www.makro.co.za/clover-full-cream-long-life-milk-plain-flavour/p/itma7f0b28c4e120?pid=MLKHFXJTMV3AMYRY" }, { "rank": 2, "product_id": "MLKHFXJTEUHFYNBF", "item_id": "ITM18645C6583944", "listing_id": "LSTMLKHFXJTEUHFYNBFWYFAJ4", "title": "Clover Nolac Lactose Free Medium Fat, Milk Flavour", "brand": "Clover", "pack_size": "6 x 1 L", "price": 109.95, "currency": "ZAR", "original_price": null, "savings": null, "discount_percent": null, "price_per_unit": null, "in_stock": true, "availability": "IN_STOCK", "seller_id": "155410923f68483e", "sold_by_makro": true, "rating": 4.7, "rating_count": 2898, "review_count": 82, "key_specs": [ "Container Type: Tetra Pack", "Flavour: Milk", "Quantity: 1 L" ], "category": { "super": "Perishables", "sub": "Dairy Milk", "leaf": "milk" }, "image": "https://www.makro.co.za/asset/rukmini/fccp/832/832/ng-fkpublic-ui-user-fbbe/milk/l/w/j/-original-imah9zzkn2tejypk.jpeg?q=70", "images": [ "https://www.makro.co.za/asset/rukmini/fccp/832/832/ng-fkpublic-ui-user-fbbe/milk/l/w/j/-original-imah9zzkn2tejypk.jpeg?q=70", "https://www.makro.co.za/asset/rukmini/fccp/832/832/ng-fkpublic-ui-user-fbbe/milk/c/i/w/-original-imah9zzktcbgrv3f.jpeg?q=70" ], "url": "https://www.makro.co.za/clover-nolac-lactose-free-medium-fat-milk-flavour/p/itm18645c6583944?pid=MLKHFXJTEUHFYNBF" }, { "rank": 3, "product_id": "MLKH2BUEDGWZ6MSM", "item_id": "ITMB715AAD2701F9", "listing_id": "LSTMLKH2BUEDGWZ6MSMBEMDZN", "title": "Clover Ultra Uht Full Cream Milk", "brand": "Clover", "pack_size": "6 x 1 L", "price": 94.95, "currency": "ZAR", "original_price": 109.95, "savings": 15, "discount_percent": 13, "price_per_unit": null, "in_stock": true, "availability": "IN_STOCK", "seller_id": "155410923f68483e", "sold_by_makro": true, "rating": 4.8, "rating_count": 627, "review_count": 13, "key_specs": [ "Container Type: Box", "Cow Milk", "Quantity: 1 L" ], "category": { "super": "Perishables", "sub": "Dairy Milk", "leaf": "milk" }, "image": "https://www.makro.co.za/asset/rukmini/fccp/832/832/ng-fkpublic-ui-user-fbbe/milk/k/g/a/-original-imah9zzkhx3rvh5n.jpeg?q=70", "images": [ "https://www.makro.co.za/asset/rukmini/fccp/832/832/ng-fkpublic-ui-user-fbbe/milk/k/g/a/-original-imah9zzkhx3rvh5n.jpeg?q=70" ], "url": "https://www.makro.co.za/clover-ultra-uht-full-cream-milk/p/itmb715aad2701f9?pid=MLKH2BUEDGWZ6MSM" } ], "subcategories": [ { "category_id": "eat,zn0", "name": "Milk", "menu_product_count": 44, "url": "https://www.makro.co.za/food-products/milk/pr?sid=eat,zn0&q=clover+milk" }, { "category_id": "eat,jj5", "name": "Dairy Cream", "menu_product_count": 2, "url": "https://www.makro.co.za/food-products/dairy-cream/pr?sid=eat,jj5&q=clover+milk" }, { "category_id": "eat,xog", "name": "Milk Powder", "menu_product_count": 4, "url": "https://www.makro.co.za/food-products/milk-powder/pr?sid=eat,xog&q=clover+milk" } ], "brands": [ { "name": "Clover", "count": 52 }, { "name": "Super M", "count": 1 } ] } }
What Makro endpoints does ReefAPI ship?
8 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Every parameter, every allowed value →
Missing a Makro endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the Makro API works
Makro is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 694 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
A daily Makro price feed, national and Cape Town
Walk the categories once to collect product ids, then refresh 100 products per call, once for the national price and once for the Western Cape. Every step was run live on 2026-11-19.
{"category_id": "eat"}Food Products: 9,724 products, more than the 50 pages (2,000 products) Makro serves for one list, so its 51 subcategories come back with their ids to walk instead.
{"category_id": "eat,zn0", "page": 1}Milk: total 141, 4 pages of 40, each row with product_id, price, was-price, stock, seller, brand and pack size. Pages 2 to 4 complete the list: 141 of 141, each product once.
{"product_ids": "MLKHFXJTMV3AMYRY,ADKHYRH8CEHFCVGZ,…"}The daily refresh: price, was-price and stock for up to 100 product ids per call, unknown ids listed in not_found. 104 of 104 batch prices matched the live makro.co.za pages.
{"product_ids": "MLKHFXJTMV3AMYRY,ADKHYRH8CEHFCVGZ,…", "postal_code": "8001"}The same ids priced for Cape Town: Sparletta Iron Brew 2 L R13.45 against R26.95 in Sandton, Clover long-life milk 6 x 1 L R94.95 in both.
Every product of the categories you follow, with the national price and the Western Cape price side by side, refreshed for a few calls per 100 products.
curl -X POST https://api.reefapi.com/makro/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"clover milk"}'{
"ok": true,
"data": { … },
"meta": {
"api": "makro",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}Same product, two Makro price regions
Live answers from 2026-11-19 for the same product ids, once with postal_code 8001 (Cape Town) and once without a postal code, which prices for Makro's default location, Sandton 2157. Soft drinks carry most of the difference; milk and TVs cost the same.
| Product, pack | Cape Town (postal_code 8001) | Sandton (default, 2157) |
|---|---|---|
| Sparletta Iron Brew, 2 L | R13.45 | R26.95 |
| TWiST Sparkling Lemon, 2 L | R13.45 | R26.95 |
| TWiST Granadilla, 6 x 2 L | R84.95 | R109.95 |
| Coca-Cola No Sugar, 6 x 300 ml | R49.95 | R57.25 |
| Coca-Cola Original Taste, 24 x 300 ml | R189.45 (dearer in Cape Town) | R179.95 |
| Clover Full Cream Long Life Milk, 6 x 1 L | R94.95, was R109.95 | R94.95, was R109.95 |
| Samsung 55" Mini LED UA55M70HA | R5,999, was R8,499 | R5,999, was R8,499 |
| Panado Paediatric Syrup | R78.95 from Makro, R240 from a marketplace seller | R240, marketplace seller only |
On 100 products across 21 postal codes there were exactly two price groups: Cape Town, Bellville, Stellenbosch and Malmesbury, and everywhere else (Johannesburg, Pretoria, Durban, Gqeberha, East London, Bloemfontein, George and others). In a separate check of 14 categories, Durban differed from Sandton on 3 of about 510 products. Stock state did not differ in any of 2,100 product and postal-code pairs.
Makro coverage, measured
533 live calls on the day the API was built, plus the examples on this page run again in the afternoon. Every price was checked against the makro.co.za page a shopper sees. Some of these lines go against us.
product: price, title and stock state equal to the live page on 30 of 30 products (10 milk, 10 TVs, 10 soft drinks). products batch: 104 of 104 prices. category page 1 of the same three lists: 104 of 104 rows, in the same order.
Milk 141 of 141 and Televisions 137 of 137, each product once. Soft drinks 577 rows with 2 repeated across pages. Confectionery (968): 955 distinct in one pass, 965 after a second; on big lists products move between pages while you page, so merge two passes by product_id.
100 products x 21 postal codes in every province: exactly two price groups, the Western Cape (Cape Town, Bellville, Stellenbosch, Malmesbury) and the rest. Cape Town differed on 32 of 40 soft drinks, 0 of 40 milk, 0 of 20 TVs; across 14 categories on about 510 products, Cape Town 36 and Durban 3. Stock state: 0 differences in 2,100 product and place pairs.
12 everyday searches answered, for example clover milk 214 results, samsung tv 239, jungle oats 132, castle lager 163, omo washing powder 90. Ranking is Makro's own: for huggies 6 of the top 10 were Huggies products, the first being a nappy-bin refill.
1,638 products in More4Less; multi-buys come with quantity and deal price ("Buy any 3 at R 50.00"). offers named a second seller where there was one, and the cheapest seller changed by region (Panado syrup: R240 marketplace only in Sandton, R78.95 from Makro in Cape Town).
155 mixed calls, six at a time: median 1.28 s, 95th percentile 1.8 s, slowest 6.9 s. Across all 533 calls, every request that had an answer got one.
40 products a page (24 for TVs and phones) and at most 50 pages per list; no EAN barcodes (Makro does not publish them); no price per kg or per unit; no per-store shelf price or stock; no review text; Makro's price sort can put a just-repriced product slightly out of order. The stores directory gave 23 stores; one of two sweeps that day returned 22.
What people build with Makro
The jobs this data is most often used for.
endpoints
credits per call
South African price-comparison sites: Makro prices next to Game, Checkers, Pick n Pay and Takealot on one key.
Daily price and stock refresh for a Makro catalogue, 100 products per call.
Western Cape pricing: the same product ids with postal_code 8001 next to the national default.
Track More4Less multi-buys and was-price discounts across the whole shop.
What Makro data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 694 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/makro/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"clover milk"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/makro/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "clover milk"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Makro.
Can I get every Makro product?▾
Yes, category by category. Every category answer gives the site's total and page count (40 products a page, 24 in TV and phone lists) plus its subcategories. Makro serves at most 50 pages of one listing (2,000 products), so a large department such as Food Products (9,724 products) is walked through its 51 subcategories. Measured on 2026-11-19: Milk 141 of 141 and Televisions 137 of 137 products, each exactly once. On very large lists products shift between pages while you page: Confectionery (968) gave 955 distinct products in one pass and 965 after a second pass, so walk in relevance order and merge two passes by product_id. Makro's own menu lists about 496,000 products across its 43 departments.
Does Makro price differently by region?▾
Mostly not, but the Western Cape is its own price region. On 100 products across 21 postal codes there were exactly two price groups: Cape Town, Bellville, Stellenbosch and Malmesbury against the rest of the country. Soft drinks differ most (32 of 40, for example Sparletta Iron Brew 2 L R13.45 in Cape Town and R26.95 in Sandton); milk, TVs, liquor, beauty, baby and groceries were the same everywhere, and a few products are dearer in Cape Town (Coca-Cola 24 x 300 ml R189.45 against R179.95). Pass postal_code, for example 8001; without it you get Makro's default location, Sandton 2157, and the answer says so.
How do I keep Makro prices up to date?▾
Keep the product ids from your category walk and call products with up to 100 ids at a time: one call returns price, was-price, discount, stock, seller, rating, image and URL for each, and lists unknown ids in not_found. On 2026-11-19, 104 of 104 batch prices matched the live makro.co.za pages. Run it once without postal_code and once with 8001 to cover both price regions.
Does Makro publish store-level prices or stock?▾
No. Makro publishes one online price per region, not a price or a stock count per store shelf. You get the 23 stores with address, province and trading hours from stores, pickup availability on the product record, and the delivery date for a postal code from offers (on 2026-11-19 a TV delivered to Cape Town and Durban four days sooner than to Sandton).
Are marketplace sellers included?▾
Yes. Every row says whether Makro sells the product itself (sold_by_makro), and offers lists every seller with price, availability and delivery date for a postal code. The seller can differ by region: on 2026-11-19 Panado Paediatric Syrup was sold only by a marketplace seller at R240 in Sandton, while in Cape Town Makro sold it for R78.95 next to that seller.
How do I get Makro's deals and multi-buys?▾
promotions lists products discounted 10 to 50 % or more against their was-price, or every product in Makro's More4Less promotion (1,638 products on 2026-11-19), across the shop, in a category or for a search. product shows each multi-buy with its quantity and deal price, for example a Gr8 Save sponge wipe at R24.95 with "Buy any 3 at R 50.00". Makro's discount filter can trail its prices, so every discount row says in discount_visible whether the product shows that discount right now (34 of the first 40 in Food Products on 2026-11-19).
Does Makro have barcodes (EAN)?▾
No. Makro does not publish barcodes on its online shop, so none is returned. Match Makro products to other shops by brand, title, pack size and model number. The Game API returns the EAN on its product call, and the Checkers API can search by barcode, so a comparison site can key Game and Checkers on the barcode and Makro on brand and pack size.
Which other South African retailers are on the same key?▾
Game (game.co.za: appliances, electronics, baby and groceries with national prices, stock per store and EAN barcodes), Checkers and Shoprite (grocery prices per delivery address, Xtra Savings prices), Pick n Pay (grocery prices per store, Smart Shopper prices) and Takealot (the marketplace, with every seller's offer). All return rand prices in the same { ok, data, meta, error } envelope, so one integration covers the set.
How fast is it?▾
In a test of 155 mixed calls, six at a time, the median was 1.28 s and the 95th percentile 1.8 s; the slowest call took 6.9 s. 154 answered, and the other was a request for a page past the end of a list, which correctly came back as not found.
Is this an official Makro API?▾
No. It is an independent API that returns what makro.co.za shows a logged-out visitor, as JSON. You need no Makro account, only a ReefAPI key.
What is the Makro API?▾
Makro API is a ReefAPI endpoint group for makro south africa prices in rand with was-prices, more4less multi-buys, stock and sellers, and cape town's separate soft-drink prices by postal code. It returns live JSON through POST requests under /makro/v1.
Is the Makro API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Makro calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Makro login or account?▾
No login to Makro is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Makro data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
362 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Makro, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-19.