Makro API & Scraper
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.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
search and category return the site's own total and page count, so a category can be walked to its last product (Milk returned 141 of 141 products and Televisions 137 of 137, each exactly once); categories walks the tree down from Makro's 43 departments; and products refreshes price and stock for up to 100 product ids in one call. product adds every specification, the model number, warranty, return policy, delivery date and pickup availability; offers lists every seller of a product with price and delivery date for a postal code; stores gives Makro's 23 stores with address, province and trading hours. Prices are mostly national, but Makro prices the Western Cape separately: on 100 products across 21 postal codes, Cape Town differed on 32 of 40 soft drinks and on none of the milk or TVs, and on 2026-11-19 Sparletta Iron Brew 2 L was R13.45 in Cape Town against R26.95 in Sandton. That is why every price call takes a postal_code. Checked against the live makro.co.za pages on 2026-11-19: 30 of 30 product records and 104 of 104 batch prices matched. No Makro account is needed: one ReefAPI key, the standard { ok, data, meta, error } envelope, and the same key reads Game, Checkers, Pick n Pay and Takealot for South African price comparison.
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.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/makro/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "clover milk"
}
}{
"ok": true,
"meta": {
"api": "makro",
"endpoint": "search",
"mode": "live",
"latency_ms": 1662.6,
"record_count": 40,
"bytes": 395609,
"cache_hit": false,
"total": 214,
"upstream_requests": 1,
"charged_credits": 2,
"version": "1.0.0",
"request_id": "6fa55f802c444674",
"fetched_at": "2026-11-19T12:33:57.134Z"
},
"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 the Makro API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Makro's online shop: price in rand, was-price, discount, stock, seller (Makro or a marketplace seller), brand, pack size, rating and image per product, with the site's total and page count. Filters: brand, price range, minimum discount, More4Less deals, sold by Makro, out-of-stock, and a category to search inside. | Pricing teams call search to search Makro's online shop. | query, category_id, page, sort, brand, ... |
| category | Every product of one Makro category, page by page, with the total and the page count so the whole category can be walked; also its subcategories with product counts (to walk a category bigger than the 50 pages the site serves). Same filters as search. | Marketplace operators call category to get every product of one Makro category, page by page, with the total and the page count so the w…. | category_id, page, sort, brand, price_min, ... |
| categories | Makro's category tree one level at a time: the top-level departments (43) or the subcategories of one category, each with its id and the product count the site shows. Walk down until a category fits in 50 pages, then page it with `category`. | Catalog enrichment teams call categories to get makro's category tree one level at a time. | category_id |
| product | One Makro product in full: price, was-price, discount, every promotion with its multi-buy price and end date, stock, seller, brand, pack size, model number, highlights, all specifications, warranty, return policy, rating, category path, all images, delivery date and the nearest pickup store's availability. | Retail analysts call product to get one Makro product in full. | product_id, postal_code |
| products | Price and stock for up to 100 Makro products in one call (one upstream request) — the cheap way to refresh a catalogue you already hold: price, was-price, discount, stock, seller, rating, image and URL per product_id; unknown ids are listed in not_found. | Pricing teams call products to get price and stock for up to 100 Makro products in one call (one upstream request). | product_ids, postal_code |
| offers | Every seller's offer for one Makro product (Makro and marketplace sellers): price, was-price, availability, delivery date, delivery charge and order cut-off for a postal code, payment modes, return policy. | Marketplace operators call offers to get every seller's offer for one Makro product (Makro and marketplace sellers). | product_id, postal_code |
| promotions | Products on a deal at Makro — discounted against their was-price (10-50% or more) or in the More4Less promotion — across the whole shop, inside a category, or matching a search. | Catalog enrichment teams call promotions to get products on a deal at Makro. | query, category_id, deal_type, min_discount, page, ... |
| stores | Makro stores: the three nearest to an address, town or postal code (name, address, province, distance, trading hours, store id), or the whole store directory with all=true. | Retail analysts call stores to get makro stores. | address, all |
Call search from your stack
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"])const res = await fetch("https://api.reefapi.com/makro/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "clover milk"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.makro.search with {"query":"clover milk"}.Who uses this API and why
- 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.
- See which products Makro sells itself and which come from marketplace sellers, and at what price.
Questions developers ask before integrating
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.