Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Makro API page →
E-commerce & Marketplaces

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.

8 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

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

Reference

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.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/makro/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "clover milk"
  }
}
Captured response
{
  "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
      }
    ]
  }
}
Actions

What the Makro API does

ActionDescriptionConcrete use caseKey params
searchSearch 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, ...
categoryEvery 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, ...
categoriesMakro'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
productOne 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
productsPrice 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
offersEvery 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
promotionsProducts 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, ...
storesMakro 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
Code samples

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"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.makro.search with {"query":"clover milk"}.
Use cases

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

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.

docs / makro

Makro

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.

base /makro/v18 endpoints
post/makro/v1/category2 credits

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.

ParameterAllowed / rangeDescription
category_idrequired—Makro category id from `categories` (e.g. 'eat,zn0' = Milk), 'all' for the whole shop, or a category URL with sid=….
page = 1optional1–50Page number, 1-50. The site's own page size is used (40 products, 24 in list-style categories such as TVs); Makro serves no page past 50, so one listing reaches at most 50 pages — walk bigger categories through `subcategories` or a price range.
sort = relevanceoptionalrelevance · popularity · price_asc · price_desc · newestOrder of the results, the site's own sort options.
brandoptional—Only these brands, written as the `brand` field of a row or a `brands` facet (one or several, comma-separated).
price_minoptional0–Lowest price in rand (inclusive).
price_maxoptional0–Highest price in rand (inclusive).
min_discountoptional10 · 20 · 30 · 40 · 50Only products discounted at least this much against their was-price.
more4less = falseoptional—Only products in Makro's More4Less promotion (multi-buy deals such as 'Buy any 3 at R 50.00' and markdowns).
sold_by_makro = falseoptional—Only products sold by Makro itself (leave out marketplace sellers).
include_out_of_stock = falseoptional—Also list out-of-stock products (the site hides them by default: Milk 141 → 170).
postal_codeoptional—South African delivery postal code (4 digits) — the location Makro prices for. Most prices are national, but Western Cape codes (e.g. 8001 Cape Town) get their own price on soft drinks and some other products (measured). Default: Makro's own default location, 2157 Sandton.
Try in playground →
post/makro/v1/categories2 credits

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

ParameterAllowed / rangeDescription
category_idoptional—Category whose subcategories to list; leave out for the top level.
Try in playground →
post/makro/v1/product2 credits

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.

ParameterAllowed / rangeDescription
product_idrequired—The 16-character product_id a search row returns, or a makro.co.za product URL containing pid=….
postal_codeoptional—South African delivery postal code (4 digits) — the location Makro prices for. Most prices are national, but Western Cape codes (e.g. 8001 Cape Town) get their own price on soft drinks and some other products (measured). Default: Makro's own default location, 2157 Sandton.
Try in playground →
post/makro/v1/products3 credits

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.

ParameterAllowed / rangeDescription
product_idsrequired—1-100 product ids (comma-separated or a list).
postal_codeoptional—South African delivery postal code (4 digits) — the location Makro prices for. Most prices are national, but Western Cape codes (e.g. 8001 Cape Town) get their own price on soft drinks and some other products (measured). Default: Makro's own default location, 2157 Sandton.
Try in playground →
post/makro/v1/offers1 credit

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.

ParameterAllowed / rangeDescription
product_idrequired—The product_id (or a product URL with pid=…).
postal_codeoptional—South African delivery postal code (4 digits) — the location Makro prices for. Most prices are national, but Western Cape codes (e.g. 8001 Cape Town) get their own price on soft drinks and some other products (measured). Default: Makro's own default location, 2157 Sandton.
Try in playground →
post/makro/v1/promotions2 credits

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.

ParameterAllowed / rangeDescription
queryoptional—Deals whose product matches this search (optional).
category_idoptional—Makro category id from `categories` / `subcategories` (e.g. 'eat' = Food Products, 'eat,zn0' = Milk) or a makro.co.za category URL containing sid=….
deal_type = discountoptionaldiscount · more4lessWhich deals: price discounts (default, at least min_discount) or the More4Less promotion.
min_discount = 10optional10 · 20 · 30 · 40 · 50With deal_type=discount: the minimum discount (default 10%).
page = 1optional1–50Page number, 1-50. The site's own page size is used (40 products, 24 in list-style categories such as TVs); Makro serves no page past 50, so one listing reaches at most 50 pages — walk bigger categories through `subcategories` or a price range.
sort = relevanceoptionalrelevance · popularity · price_asc · price_desc · newestOrder of the results, the site's own sort options.
brandoptional—Only these brands, written as the `brand` field of a row or a `brands` facet (one or several, comma-separated).
price_minoptional0–Lowest price in rand (inclusive).
price_maxoptional0–Highest price in rand (inclusive).
sold_by_makro = falseoptional—Only products sold by Makro itself (leave out marketplace sellers).
postal_codeoptional—South African delivery postal code (4 digits) — the location Makro prices for. Most prices are national, but Western Cape codes (e.g. 8001 Cape Town) get their own price on soft drinks and some other products (measured). Default: Makro's own default location, 2157 Sandton.
Try in playground →
post/makro/v1/stores1 credit

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.

ParameterAllowed / rangeDescription
addressoptional—A town, suburb or address in South Africa (postal codes work in the metros; a town name is safer).
all = falseoptional—Return every Makro store (the directory, swept from the site's own store lookup across the country).
Try in playground →
Built for volume
5M+ requests a day

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.

Missing a source?
We build it

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.

Support
2 minute median reply

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.

One key, one balance
Every API included

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.