makro.co.za APIwww.makro.co.za ↗
Search Makro South Africa's product catalog via API. Get product names, prices, images, brand, and ratings for up to 24 results per page.
curl -X POST 'https://api.parse.bot/scraper/1cdaa9e6-11b8-4b19-8960-115fcba2c0d4/search_products' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{}'Search for products by name on Makro South Africa. Returns paginated results with product name, price, image URL, brand, rating, and other details. Each page returns up to 24 products.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. Must be a positive integer. |
| queryrequired | string | Search query text for finding products (e.g. 'laptop', 'tv', 'headphones'). |
{
"type": "object",
"fields": {
"page": "integer",
"query": "string",
"products": "array of product objects with product_id, name, subtitle, price, image_url, brand, rating, rating_count",
"total_results": "integer",
"has_more_pages": "boolean"
},
"sample": {
"data": {
"page": 1,
"query": "laptop",
"products": [
{
"name": "Lenovo IdeaPad Slim 3 Intel Core i3 N305 - (8 GB/256 GB SSD/Windows 11 Home) IdeaPad Slim3 15IAN8 Thin and Light Laptop",
"brand": "Lenovo",
"price": 7999,
"rating": 5,
"subtitle": "15.6 inch, Grey, 1.55 kg",
"image_url": "https://www.makro.co.za/asset/rukmini/fccp/312/312/ng-fkpublic-ui-user-fbbe/laptop/f/r/z/-original-imahbacrsh2b6vgh.jpeg?q=70",
"product_id": "LTPHBACYDNYBYGST",
"rating_count": 2
}
],
"total_results": 736,
"has_more_pages": true
},
"status": "success"
}
}About the makro.co.za API
The Makro South Africa API exposes one endpoint — search_products — that queries the makro.co.za catalog and returns up to 8 structured fields per product, including name, price, image URL, brand, and rating. A single POST request with a search term like "laptop" or "tv" yields paginated results with a total result count and a flag indicating whether additional pages exist.
What the API Returns
The search_products endpoint accepts a query string and an optional page integer, then returns a list of product objects from the makro.co.za catalog. Each product object contains product_id, name, subtitle, price, image_url, brand, rating, and rating_count. The top-level response also includes total_results and has_more_pages, making it straightforward to iterate through all matching pages programmatically.
Pagination
Each call returns at most 24 products. Use the page parameter (positive integer) to walk through deeper result sets. The has_more_pages boolean tells you whether another page exists without requiring you to compare counts manually. total_results reports the full match count across all pages, so you can calculate how many requests a full crawl requires before starting.
Coverage Scope
The API covers the South African Makro catalog at makro.co.za, which includes grocery, electronics, appliances, furniture, and general merchandise categories. Product pricing is returned in South African Rand as displayed on the site. Rating data (rating and rating_count) is included where available for a given product; some products may carry empty values for these fields if no reviews exist.
- Track price changes for specific products across the Makro catalog over time using
pricefield snapshots. - Build a price comparison tool that queries multiple retailers and surfaces makro.co.za
pricealongside competitors. - Populate an affiliate product feed with Makro
name,image_url,brand, andpricefields. - Filter high-rated Makro products by category using
ratingandrating_countto surface well-reviewed items. - Monitor stock breadth for a product category (e.g. 'headphones') using
total_resultsacross search queries. - Seed a product database for a South African e-commerce analytics tool using
product_idas a stable identifier. - Automate competitive intelligence reports by querying brand-specific terms and aggregating
pricedistributions.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Makro South Africa offer an official developer API?+
What does the search_products endpoint return for each product?+
product_id, name, subtitle, price, image_url, brand, rating, and rating_count. The response also returns total_results, page, query, and has_more_pages at the top level so you can manage pagination without extra requests.Does the API return product availability or stock status?+
Can I retrieve product details for a specific product ID rather than searching by keyword?+
query string. It returns product_id values in responses, but there is no separate endpoint for direct product lookup by ID. You can fork this API on Parse and revise it to add a product detail endpoint using the returned IDs.