Game South Africa API & Scraper
The Game South Africa API returns game.co.za, the online shop of the Game chain (96 stores in all nine provinces), as JSON: about 18,900 products across appliances, TVs, phones, gaming, baby, groceries, household and garden, each with the price in rand, the was-price and saving, multi-buy deals with their end date, stock at one Game store, brand, category, 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.
Game's prices are national: on 2026-11-19 the same 170 Samsung products carried the same price and was-price in all 86 stores read, and 249 grocery and Huggies products were identical in 27 stores across the nine provinces. Stock is not: Huggies Giga size 5 (R379.99, was R549.99) had 14 packs at Game West Street in Durban and 99 at Canal Walk in Cape Town the same afternoon. So every call returns prices that hold everywhere and the stock of one store, chosen with store_id or a delivery address; without either, Game's default store (Mall of Africa) is used and the answer says so. search finds products by keyword with total and page count, six sorts and filters for brand, price band, product group, category and promotion; category walks any category, or the whole catalogue, 100 products a page (18,904 of 18,904 products in 190 pages, none repeated or missing); product adds the EAN barcode, manufacturer part number, specifications, every image, variants with their own price and stock, deals with end dates and delivery and collection estimates; promotions lists every product on a deal or in one campaign such as Black Friday; deal lists every product a multi-buy covers; categories, stores and locate_store give the category tree, the 96 stores with coordinates and opening hours, and the store that serves an address. No Game account: one ReefAPI key, the standard { ok, data, meta, error } envelope, and the same key reads Makro, Checkers, Pick n Pay and Takealot for South African price comparison.
What a Game field actually contains
Fields that read differently from how they look. Every row was measured against live responses on 2026-11-19.
| Field | What it holds |
|---|---|
| price | The single-unit price anyone pays, in rand. National: identical in every store read (170 electronics products in 86 stores, 249 grocery and baby products in 27 stores across nine provinces). |
| original_price, savings, savings_percent | The was-price and the saving when the product is reduced: the LOGIK immersed kettle reads price 179, original_price 199, savings 20, savings_percent 10.05. null, not 0, when there is no was-price. Across the whole catalogue the saving always equals was-price minus price. |
| deals | Multi-buy offers kept apart from the price, with promotion_id, text, quantity, deal price and end date: "Maggi 2 min noodless 68g 2 for R130" on 12-packs at R69.99, ending 2027-01-31. The deal call lists every product that counts towards one. |
| stock_level, in_stock, store_id | Units on hand at the store in store_id. Different per store: the LOGIK kettle had 67 units at Mall of Africa and 44 at Canal Walk; Huggies Giga size 5 between 9 and 99 packs across seven stores. |
| ean, mpn | The barcode and manufacturer part number, on the product call (28 of 28 products checked carried an EAN; the part number 8 of 28). Search rows do not carry the barcode, and Game's search does not find a product by barcode. |
| tags, online_only, clearance | Game's own badges: BLACK_FRIDAY, CLEARANCE, ONLINE_ONLY. |
| variants | Flavours, colours or sizes of one product, each with its own product_id, price and stock (Maggi 12-pack noodles: Beef 50, Chicken 6, Durban Curry 28 units at the default store). |
| category_path | The department, sub-department and category; the categories call gives their ids for category and search. |
| image, images | Full-size product photo and thumbnails. The file names look generic ("Default-Product-…") but each is the product's own photo. |
| hours (stores) | Opening hours per weekday on a 24-hour clock ("08:00-19:00"), plus parking, entrance and the collection estimate the site shows. |
Game does not publish a price per store (prices are national), a price per kg or per 100 ml, or review text; the product record carries the review count only.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/game-za/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "kettle",
"page_size": 24
}
}{
"ok": true,
"meta": {
"api": "game-za",
"endpoint": "search",
"mode": "live",
"latency_ms": 1606.5,
"record_count": 24,
"bytes": 68577,
"cache_hit": false,
"total": 118,
"store_id": "G205",
"upstream_requests": 1,
"charged_credits": 2,
"version": "0.1.0",
"request_id": "09c63a35f08e4819",
"fetched_at": "2026-11-19T12:33:56.859Z"
},
"data": {
"query": "kettle",
"category_id": null,
"store_id": "G205",
"store_name": "Game Mall Of Africa",
"store_defaulted": true,
"location": null,
"total": 118,
"total_pages": 5,
"page": 1,
"page_size": 24,
"returned": 24,
"sort": "relevance",
"facets": {
"categories": [
{
"value": "Kettles",
"count": 73,
"selected": false
},
{
"value": "Kettle Braais",
"count": 9,
"selected": false
},
{
"value": "Dumb-Bells",
"count": 6,
"selected": false
}
],
"price_ranges": [
{
"value": "R25.00 - R49.99",
"count": 1,
"selected": false
},
{
"value": "R50.00 - R99.99",
"count": 5,
"selected": false
},
{
"value": "R100.00 - R149.99",
"count": 10,
"selected": false
}
],
"brands": [
{
"value": "LOGIK",
"count": 23,
"selected": false
},
{
"value": "EIGER",
"count": 10,
"selected": false
},
{
"value": "TROJAN",
"count": 10,
"selected": false
}
],
"promotions": [
{
"value": "Savings",
"count": 33,
"selected": false
}
],
"ratings": [
{
"value": "1 star and above",
"count": 5,
"selected": false
},
{
"value": "2 stars and above",
"count": 5,
"selected": false
},
{
"value": "3 stars and above",
"count": 13,
"selected": false
}
]
},
"products": [
{
"rank": 1,
"product_id": "000000000850028253",
"title": "LOGIK IMMERSED KETTLE",
"brand": "LOGIK",
"price": 179,
"currency": "ZAR",
"original_price": 199,
"savings": 20,
"savings_percent": 10.05,
"on_promotion": true,
"deals": [],
"in_stock": true,
"stock_status": "inStock",
"stock_level": 67,
"stock_level_rounded": false,
"store_id": "G205",
"category_path": [
"Home-Appliances",
"Kitchen-Small-Appliances",
"Kettles-Coffee-Machines"
],
"tags": [
"BLACK_FRIDAY"
],
"online_only": false,
"clearance": false,
"store_only": false,
"pre_order": false,
"unit": "EA",
"image": "https://api-beta-game.walmart.com/medias/Default-Product-Default-WF-null?context=bWFzdGVyfHByb2Nlc3NlZHwxMTgwNHxpbWFnZS9qcGVnfGFHRmtMMmc0WVM4MU1EVTBOREEzTWpFNU5qRXlOaTlFWldaaGRXeDBMVkJ5YjJSMVkzUmZSR1ZtWVhWc2RDMVhSbDl1ZFd4c3xhMzA2MTQ2M2U0ZDBkNGE4YzJjNWYyMzgxMTAwZmIyOTJjZDY0NDZkZDFiMjVlNzY2MGQ1Y2ZjNDNjZGMyZTY3",
"images": [
"https://api-beta-game.walmart.com/medias/Default-Thumbnail-Default-WF-null?context=bWFzdGVyfHByb2Nlc3NlZHwxMDE5fGltYWdlL2pwZWd8YURsakwyZzROeTgxTURVME5EQTNNakkyTVRZMk1pOUVaV1poZFd4MExWUm9kVzFpYm1GcGJGOUVaV1poZFd4MExWZEdYMjUxYkd3fDU5YzE3N2VlNzQzNzI0MzBkY2Q0NDUxYzJmZGIwYTZlNjIyZDBjNTMyZGE0NjY3OTNhNDI4NzVmZWY0Mjg3Y2U",
"https://api-beta-game.walmart.com/medias/Default-Product-Default-WF-null?context=bWFzdGVyfHByb2Nlc3NlZHwxMTgwNHxpbWFnZS9qcGVnfGFHRmtMMmc0WVM4MU1EVTBOREEzTWpFNU5qRXlOaTlFWldaaGRXeDBMVkJ5YjJSMVkzUmZSR1ZtWVhWc2RDMVhSbDl1ZFd4c3xhMzA2MTQ2M2U0ZDBkNGE4YzJjNWYyMzgxMTAwZmIyOTJjZDY0NDZkZDFiMjVlNzY2MGQ1Y2ZjNDNjZGMyZTY3"
],
"url": "https://www.game.co.za/Home-Appliances/Kitchen-Small-Appliances/Kettles-Coffee-Machines/p/000000000850028253"
},
{
"rank": 2,
"product_id": "000000000850028243",
"title": "LOGIK CORDLESS KETTLE",
"brand": "LOGIK",
"price": 179,
"currency": "ZAR",
"original_price": 199,
"savings": 20,
"savings_percent": 10.05,
"on_promotion": true,
"deals": [],
"in_stock": true,
"stock_status": "inStock",
"stock_level": 13,
"stock_level_rounded": false,
"store_id": "G205",
"category_path": [
"Home-Appliances",
"Kitchen-Small-Appliances",
"Kettles-Coffee-Machines"
],
"tags": [
"BLACK_FRIDAY"
],
"online_only": false,
"clearance": false,
"store_only": false,
"pre_order": false,
"unit": "EA",
"image": "https://api-beta-game.walmart.com/medias/Default-Product-Default-WF-null?context=bWFzdGVyfHByb2Nlc3NlZHwxODcxMnxpbWFnZS9qcGVnfGFHSXpMMmhpWmk4ME9Ua3dNek15TVRrek9UazVPQzlFWldaaGRXeDBMVkJ5YjJSMVkzUmZSR1ZtWVhWc2RDMVhSbDl1ZFd4c3xlNDg0MzUxMGNmN2U3OGZmZTYxYmU0ZTdjNmQyNDBhNGU3OTUxNjU4N2ExMWUyY2VmYWJmOTY0NWFhZjFhNDVk",
"images": [
"https://api-beta-game.walmart.com/medias/Default-Thumbnail-Default-WF-null?context=bWFzdGVyfHByb2Nlc3NlZHwxNjQwfGltYWdlL2pwZWd8YUdZMkwyZzNOQzgwT1Rrd016TXlNakF3TlRVek5DOUVaV1poZFd4MExWUm9kVzFpYm1GcGJGOUVaV1poZFd4MExWZEdYMjUxYkd3fDBkOGMwN2EzNzJiMzVhZDlkMTAzNjNkMDNkOTAyZmI0YzkwNzFmNDczOTBkODEyMWVkNTY1MTVkODFkYWFjZmM",
"https://api-beta-game.walmart.com/medias/Default-Product-Default-WF-null?context=bWFzdGVyfHByb2Nlc3NlZHwxODcxMnxpbWFnZS9qcGVnfGFHSXpMMmhpWmk4ME9Ua3dNek15TVRrek9UazVPQzlFWldaaGRXeDBMVkJ5YjJSMVkzUmZSR1ZtWVhWc2RDMVhSbDl1ZFd4c3xlNDg0MzUxMGNmN2U3OGZmZTYxYmU0ZTdjNmQyNDBhNGU3OTUxNjU4N2ExMWUyY2VmYWJmOTY0NWFhZjFhNDVk"
],
"url": "https://www.game.co.za/Home-Appliances/Kitchen-Small-Appliances/Kettles-Coffee-Machines/p/000000000850028243"
},
{
"rank": 3,
"product_id": "000000000850028237",
"title": "LOGIK GLASS KETTLE",
"brand": "LOGIK",
"price": 359,
"currency": "ZAR",
"original_price": null,
"savings": null,
"savings_percent": null,
"on_promotion": false,
"deals": [],
"in_stock": true,
"stock_status": "inStock",
"stock_level": 28,
"stock_level_rounded": false,
"store_id": "G205",
"category_path": [
"Home-Appliances",
"Kitchen-Small-Appliances",
"Kettles-Coffee-Machines"
],
"tags": [],
"online_only": false,
"clearance": false,
"store_only": false,
"pre_order": false,
"unit": "EA",
"image": "https://api-beta-game.walmart.com/medias/Default-Product-Default-WF-null?context=bWFzdGVyfHByb2Nlc3NlZHwyMzU5OHxpbWFnZS9qcGVnfGFHWmtMMmhrTXk4ME9Ua3dNek15TVRNMU1ERTNOQzlFWldaaGRXeDBMVkJ5YjJSMVkzUmZSR1ZtWVhWc2RDMVhSbDl1ZFd4c3xiZTM0YWJmOTRhYjU0YWIyYzA2MTgyNTcwNTE1ZTcxNDJmZGEwZjNjZmRiODUxOTUzZDY3YjBkZDYzODk4N2Y0",
"images": [
"https://api-beta-game.walmart.com/medias/Default-Thumbnail-Default-WF-null?context=bWFzdGVyfHByb2Nlc3NlZHwxNjUxfGltYWdlL2pwZWd8YURBd0wyaGtNUzgwT1Rrd016TXlNVFF4TlRjeE1DOUVaV1poZFd4MExWUm9kVzFpYm1GcGJGOUVaV1poZFd4MExWZEdYMjUxYkd3fDMzNWYwYjdmYjFlMzA1ODM3NzlmMzg2MzdiNzA5ZGQyYjFjYzQyMmY0NGMyNGRiNDgzNzg5OTMzZGVkNDY4MjY",
"https://api-beta-game.walmart.com/medias/Default-Product-Default-WF-null?context=bWFzdGVyfHByb2Nlc3NlZHwyMzU5OHxpbWFnZS9qcGVnfGFHWmtMMmhrTXk4ME9Ua3dNek15TVRNMU1ERTNOQzlFWldaaGRXeDBMVkJ5YjJSMVkzUmZSR1ZtWVhWc2RDMVhSbDl1ZFd4c3xiZTM0YWJmOTRhYjU0YWIyYzA2MTgyNTcwNTE1ZTcxNDJmZGEwZjNjZmRiODUxOTUzZDY3YjBkZDYzODk4N2Y0"
],
"url": "https://www.game.co.za/Home-Appliances/Kitchen-Small-Appliances/Kettles-Coffee-Machines/p/000000000850028237"
}
]
}
}What the Game South Africa API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Game South Africa (game.co.za) by keyword: price in rand, was-price and saving, multi-buy deals, stock at one Game store, brand, image and product URL per product, with total and total_pages for paging, sort, and filters by brand, price band, category and promotion. Up to 100 products per page. | Pricing teams call search to search Game South Africa (game.co.za) by keyword. | query, category_id, brand, price_range, subcategory, ... |
| category | Every product in one Game category, page by page (100 per page): total and total_pages say how many pages to walk; the same filters as search. category_id 'root_sale_cat' walks the whole catalogue (~18,900 products). | Marketplace operators call category to get every product in one Game category, page by page (100 per page). | category_id, brand, price_range, subcategory, on_promotion, ... |
| product | One Game product by code or URL: name, brand, price, was-price, multi-buy deals with end date, stock at one store, barcode (EAN), manufacturer part number, description, specifications, all images, variants (flavour / colour / size, each with its own price and stock), breadcrumb, delivery and collection estimates, review count. | Catalog enrichment teams call product to get one Game product by code or URL. | product_id, store_id, latitude, longitude, postal_code |
| promotions | Game's deal listings, page by page: every product on promotion (campaign allPromotions, default) or one campaign such as black-friday — price, was-price, saving, multi-buy deals, stock per product. | Retail analysts call promotions to get game's deal listings, page by page. | campaign, brand, price_range, subcategory, sort, ... |
| deal | One multi-buy deal (e.g. '2 for R130') from a product's deals[]: its text, start and end dates and every product that counts towards it, with price and stock. | Pricing teams call deal to get one multi-buy deal (e.g. | product_id, promotion_id, store_id, latitude, longitude, ... |
| categories | Game's category tree (15 departments, ~93 sub-departments, ~560 leaf categories) with the ids `category` and `search` take; or one department's subtree. | Marketplace operators call categories to get game's category tree (15 departments, ~93 sub-departments, ~560 leaf categories) with the ids…. | category_id |
| stores | All Game stores in South Africa (96): store id, name, street address, province, coordinates, phone, opening hours per day, parking; optionally nearest first to a point, or one province. | Catalog enrichment teams call stores to get all Game stores in South Africa (96). | latitude, longitude, province, store_id, limit |
| locate_store | Which Game store the site uses for a delivery address (its stock is what search / product show there): the site's own address-to-store mapping, plus that store's details. | Retail analysts call locate_store to get which Game store the site uses for a delivery address (its stock is what search / product sho…. | latitude, longitude, postal_code |
| suggest | The site's search-as-you-type: up to 10 product suggestions with price and the matching categories for a partial word. | Pricing teams call suggest to get the site's search-as-you-type. | query, store_id |
Call search from your stack
curl -X POST https://api.reefapi.com/game-za/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"kettle","page_size":24}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/game-za/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "kettle",
"page_size": 24
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/game-za/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "kettle",
"page_size": 24
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.game-za.search with {"query":"kettle","page_size":24}.Who uses this API and why
- South African price-comparison sites: Game prices matched to other retailers by EAN barcode.
- A daily Game price, was-price and deal feed for the whole catalogue in 190 calls.
- Check stock of a product at the Game store nearest a customer before sending them there.
- Track Black Friday and multi-buy deals with their end dates.
- Map Game's 96 stores with coordinates and opening hours.
Questions developers ask before integrating
Are Game prices different per store or region?
No. On 2026-11-19 the same 170 Samsung products had the same price and was-price in all 86 stores read, and 249 grocery and baby products were identical in 27 stores across all nine provinces. Stock levels do differ per store (Huggies Giga size 5: 14 packs at West Street, 99 at Canal Walk), and that is what store_id changes.
How do I get every Game product?
Call category with category_id root_sale_cat (the whole catalogue) or any department, 100 products a page, and follow total_pages. On 2026-11-19 the whole-catalogue walk returned all 18,904 products in 190 pages, none repeated or missing, 11,016 of them in stock at the default store; Home Appliances returned 1,009 of 1,009. Walking the catalogue once a day costs 190 calls.
Can I get the barcode (EAN)?
Yes, from the product call: 28 of 28 products checked carried an EAN (Huggies Giga size 5: 6001019912050), plus the manufacturer part number where Game publishes it. Search and category rows do not carry it, and Game's search does not find a product by barcode, so read the barcode once per new product with product.
How do I pick the store?
Pass store_id (G041 = Game West Street, G060 = Game Canal Walk; the stores call lists all 96) or a delivery address as latitude and longitude, which Game maps to its own store: central Cape Town to Canal Walk, Sandton to Rosebank, central Durban to West Street. locate_store tells you which store an address gets.
Which filters and sorts work?
Sort by relevance, price, name or rating; filter by brand, price band, product group, category and on promotion. Each was checked against the unfiltered count for "kettle" (118): brand LOGIK 23 (23 of 23 rows LOGIK), R150.00 - R199.99 12 (12 of 12 in the band), on promotion 33 (33 of 33 with a deal or was-price), category Kettles & Coffee Machines 90. Game lists products in stock first, then out-of-stock ones, each group in the order you asked.
How do I get Game's deals?
promotions lists every product on a deal (1,575 on 2026-11-19) or one campaign such as black-friday (351). Each row carries the was-price and any multi-buy; deal takes a promotion_id from a row and lists every product that counts towards it, for example the three Maggi noodle 12-packs in "2 for R130".
Which other South African retailers are on the same key?
Makro (makro.co.za: groceries, liquor and general merchandise, with the Western Cape priced separately and a 100-product batch refresh, but no barcodes), Checkers and Shoprite (grocery prices per delivery address), Pick n Pay (grocery prices per store) and Takealot (the marketplace, with every seller's offer). Game and Checkers both give barcodes, which makes them the easiest pair to match product by product.
How fresh and how fast is it?
Every call reads the site live; only the store list and category tree are kept, for up to six hours. In a 90-call test with six calls at a time all 90 answered, with a median of 1.4 s and 2.2 s at the 95th percentile.
Is this an official Game API?
No. It is an independent API that returns what game.co.za shows a logged-out visitor, as JSON. You need no Game account, only a ReefAPI key.
What is the Game South Africa API?
Game South Africa API is a ReefAPI endpoint group for game (game.co.za) prices in rand, was-prices and multi-buy deals, stock at each of 96 game stores, ean barcodes and the whole 18,900-product catalogue. It returns live JSON through POST requests under /game-za/v1.
Is the Game South Africa API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Game South Africa calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Game South Africa login or account?
No login to Game South Africa 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 Game South Africa data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Game South Africa API use?
Game South Africa actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.