Makro API

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

POST/makro/v1/search200
  1. Clover Full Cream Long Life Milk, Plain Flavour94.95 ZAR
    rank
    1
    brand
    Clover
  2. Clover Nolac Lactose Free Medium Fat, Milk Flavour109.95 ZAR
    rank
    2
    brand
    Clover
  3. Clover Ultra Uht Full Cream Milk94.95 ZAR
    rank
    3
    brand
    Clover
Real result, captured Nov 19, 20263 of 40
Try it live

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

View docs ↗

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.

2 credits1 required · 3 optional
POST/makro/v1/search
ok1184 ms · 40 records · sample
{
  "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
      }
    ]
  }
}
Real response, fetched from the live endpoint with the parameters on the left — trimmed to the first few rows, with seller names left out. Press Try it for the untrimmed response.

Try every endpoint in the playground

Endpoints

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.

8 endpoints

search

2 cr

Search Makro's online shop.

required
query
optional
category_id, page, sort, brand, price_min, price_max, min_discount, more4less, sold_by_makro, include_out_of_stock, postal_code

category

2 cr

Every product of one Makro category, page by page, with the total and the page count so the w…

required
category_id
optional
page, sort, brand, price_min, price_max, min_discount, more4less, sold_by_makro, include_out_of_stock, postal_code

categories

2 cr

Makro's category tree one level at a time.

required
—
optional
category_id

product

2 cr

One Makro product in full.

required
product_id
optional
postal_code

products

3 cr

Price and stock for up to 100 Makro products in one call (one upstream request).

required
product_ids
optional
postal_code

offers

1 cr

Every seller's offer for one Makro product (Makro and marketplace sellers).

required
product_id
optional
postal_code

promotions

2 cr

Products on a deal at Makro.

required
—
optional
query, category_id, deal_type, min_discount, page, sort, brand, price_min, price_max, sold_by_makro, postal_code

stores

1 cr

Makro stores.

required
—
optional
address, all

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 it works

How the Makro API works

Makro is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

02
Call
POST /makro/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 or 2 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

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.

01categories
POST/makro/v1/categories
{"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.

02category
POST/makro/v1/category
{"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.

03products
POST/makro/v1/products
{"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.

04products
POST/makro/v1/products
{"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.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "makro",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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, packCape Town (postal_code 8001)Sandton (default, 2157)
Sparletta Iron Brew, 2 LR13.45R26.95
TWiST Sparkling Lemon, 2 LR13.45R26.95
TWiST Granadilla, 6 x 2 LR84.95R109.95
Coca-Cola No Sugar, 6 x 300 mlR49.95R57.25
Coca-Cola Original Taste, 24 x 300 mlR189.45 (dearer in Cape Town)R179.95
Clover Full Cream Long Life Milk, 6 x 1 LR94.95, was R109.95R94.95, was R109.95
Samsung 55" Mini LED UA55M70HAR5,999, was R8,499R5,999, was R8,499
Panado Paediatric SyrupR78.95 from Makro, R240 from a marketplace sellerR240, 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.

Coverage

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.

Price accuracy

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.

Whole categories

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.

Two price regions

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.

Searches

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.

Deals and sellers

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).

Speed

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.

Limits

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.

Use cases

What people build with Makro

The jobs this data is most often used for.

8

endpoints

1/2/3

credits per call

01

South African price-comparison sites: Makro prices next to Game, Checkers, Pick n Pay and Takealot on one key.

02

Daily price and stock refresh for a Makro catalogue, 100 products per call.

03

Western Cape pricing: the same product ids with postal_code 8001 next to the national default.

04

Track More4Less multi-buys and was-price discounts across the whole shop.

Pricing

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.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 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
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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
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"}'
python
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"])
FAQ

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.

Contact

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.

0/4000

No account needed · we reply from [email protected]

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.