# Game South Africa API — game.co.za prices in rand, was-prices and multi-buy deals, stock per Game store, barcode (EAN), specs, images, every category page by page, deals, and the 96-store directory

> 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.
> ReefAPI engine `game-za` · 9 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/game-za/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/game-za/v1/search — 2 credits
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.

**Parameters:**
- `query` (string, required) — What to search for, as typed in the site's search box. A barcode is not searchable on Game (0 results) — use `product` for EAN.
- `category_id` (string, optional) — Category id from `categories` (G101 level 1, G2053 level 2, G3232 level 3).
- `brand` (string, optional) — Only this brand, exactly as the `facets.brands` values spell it (upper case, e.g. SAMSUNG, RUSSELL HOBBS). Matching is case-insensitive here.
- `price_range` (string, optional) — Only this price band, one of the `facets.price_ranges` values (the site's fixed bands, e.g. 'R150.00 - R199.99'). 'R150-R199.99' is accepted too.
- `subcategory` (string, optional) — Only this product group, exactly as a `facets.categories` value spells it (the site's own finer grouping, e.g. '50 - 59" UHD TV's', 'Kettles').
- `on_promotion` (boolean, optional, default false) — Only products on promotion (the site's 'Promotions: Savings' filter).
- `sort` (enum, optional, default "relevance") — Sort order (the site's own six). The site always lists in-stock products first, then out-of-stock ones, each group in this order. For walking a whole category use name_asc (measured: 1,009 of 1,009 products, no page overlap). [one of: relevance, price_asc, price_desc, name_asc, name_desc, rating_desc]
- `page` (integer, optional, default 1) — Page number, 1-based. `total_pages` in the answer says how many there are.
- `page_size` (integer, optional, default 100) — Products per page, 1-100 (the site's own maximum; default 100).
- `store_id` (string, optional) — Game store code (G095 = Game Eastgate; `stores` lists all 96). Stock levels are that store's; prices are national (measured identical in 86 stores). Without store_id or an address the site's own default store G205 (Game Mall of Africa) is used and the answer says store_defaulted: true.
- `latitude` (number, optional) — Delivery address latitude (with longitude): the site maps the address to the Game store that serves it and that store's stock is returned (one extra request).
- `longitude` (number, optional) — Delivery address longitude (with latitude).
- `postal_code` (string, optional) — Optional South African postal code sent with latitude/longitude, as the site does.
- `include_facets` (boolean, optional, default true) — Return the filter counts (brands, price bands, sub-categories, promotions). false = lighter page (~35% fewer bytes) for whole-catalogue walks.

**Returns:** query, category_id, spelling_suggestion, store_id, store_name, store_defaulted, location, total, total_pages, page, page_size, returned, sort, facets{brands[], price_ranges[], categories[], promotions[], ratings[]}, products[]{rank, product_id, title, brand, price, currency, original_price (was-price), savings, savings_percent, on_promotion, deals[]{promotion_id, text, quantity, deal_price, ends}, in_stock, stock_status, stock_level (units at store_id), stock_level_rounded, store_id, category_path[], tags[], online_only, clearance, store_only, pre_order, unit, image, images[], url}

**Example request body:**
```json
{
  "query": "kettle",
  "page_size": 24
}
```

### POST https://api.reefapi.com/game-za/v1/category — 2 credits
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).

**Parameters:**
- `category_id` (string, required) — Category id from `categories` (any level), or root_sale_cat for the whole catalogue.
- `brand` (string, optional) — Only this brand, exactly as the `facets.brands` values spell it (upper case, e.g. SAMSUNG, RUSSELL HOBBS). Matching is case-insensitive here.
- `price_range` (string, optional) — Only this price band, one of the `facets.price_ranges` values (the site's fixed bands, e.g. 'R150.00 - R199.99'). 'R150-R199.99' is accepted too.
- `subcategory` (string, optional) — Only this product group, exactly as a `facets.categories` value spells it (the site's own finer grouping, e.g. '50 - 59" UHD TV's', 'Kettles').
- `on_promotion` (boolean, optional, default false) — Only products on promotion (the site's 'Promotions: Savings' filter).
- `sort` (enum, optional, default "relevance") — Sort order (the site's own six). The site always lists in-stock products first, then out-of-stock ones, each group in this order. For walking a whole category use name_asc (measured: 1,009 of 1,009 products, no page overlap). [one of: relevance, price_asc, price_desc, name_asc, name_desc, rating_desc]
- `page` (integer, optional, default 1) — Page number, 1-based. `total_pages` in the answer says how many there are.
- `page_size` (integer, optional, default 100) — Products per page, 1-100 (the site's own maximum; default 100).
- `store_id` (string, optional) — Game store code (G095 = Game Eastgate; `stores` lists all 96). Stock levels are that store's; prices are national (measured identical in 86 stores). Without store_id or an address the site's own default store G205 (Game Mall of Africa) is used and the answer says store_defaulted: true.
- `latitude` (number, optional) — Delivery address latitude (with longitude): the site maps the address to the Game store that serves it and that store's stock is returned (one extra request).
- `longitude` (number, optional) — Delivery address longitude (with latitude).
- `postal_code` (string, optional) — Optional South African postal code sent with latitude/longitude, as the site does.
- `include_facets` (boolean, optional, default true) — Return the filter counts (brands, price bands, sub-categories, promotions). false = lighter page (~35% fewer bytes) for whole-catalogue walks.

**Returns:** category_id, category_name, category_path[], store_id, store_name, store_defaulted, location, total, total_pages, page, page_size, returned, sort, facets{brands[], price_ranges[], categories[], promotions[], ratings[]}, products[]{rank, product_id, title, brand, price, currency, original_price (was-price), savings, savings_percent, on_promotion, deals[]{promotion_id, text, quantity, deal_price, ends}, in_stock, stock_status, stock_level (units at store_id), stock_level_rounded, store_id, category_path[], tags[], online_only, clearance, store_only, pre_order, unit, image, images[], url}

**Example request body:**
```json
{
  "category_id": "G2053",
  "page_size": 24
}
```

### POST https://api.reefapi.com/game-za/v1/product — 1 credit
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.

**Parameters:**
- `product_id` (string, required) — The product code from a search row (18 digits; the leading zeros may be left out: 130293) or a game.co.za product URL.
- `store_id` (string, optional) — Game store code (G095 = Game Eastgate; `stores` lists all 96). Stock levels are that store's; prices are national (measured identical in 86 stores). Without store_id or an address the site's own default store G205 (Game Mall of Africa) is used and the answer says store_defaulted: true.
- `latitude` (number, optional) — Delivery address latitude (with longitude): the site maps the address to the Game store that serves it and that store's stock is returned (one extra request).
- `longitude` (number, optional) — Delivery address longitude (with latitude).
- `postal_code` (string, optional) — Optional South African postal code sent with latitude/longitude, as the site does.

**Returns:** store_id, store_name, store_defaulted, location, product{product_id, title, brand, ean, mpn, price, currency, original_price, savings, savings_percent, on_promotion, deals[], in_stock, stock_status, stock_level, purchasable, available_for_pickup, same_day_pickup, pickup_message, delivery_estimate, warranty, returnable, description, specifications[]{group, name, value}, dimensions{height, width, length}, variants[]{product_id, attribute, value, price, in_stock, stock_level, url}, breadcrumb[]{category_id, name}, category_path[], tags[], review_count, base_product, unit, images[], image, url}

**Example request body:**
```json
{
  "product_id": "000000000000130293"
}
```

### POST https://api.reefapi.com/game-za/v1/promotions — 2 credits
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.

**Parameters:**
- `campaign` (string, optional, default "allPromotions") — Campaign code from the site's deal pages (game.co.za/l/v/<code>): allPromotions (all deals, default), black-friday, …
- `brand` (string, optional) — Only this brand, exactly as the `facets.brands` values spell it (upper case, e.g. SAMSUNG, RUSSELL HOBBS). Matching is case-insensitive here.
- `price_range` (string, optional) — Only this price band, one of the `facets.price_ranges` values (the site's fixed bands, e.g. 'R150.00 - R199.99'). 'R150-R199.99' is accepted too.
- `subcategory` (string, optional) — Only this product group, exactly as a `facets.categories` value spells it (the site's own finer grouping, e.g. '50 - 59" UHD TV's', 'Kettles').
- `sort` (enum, optional, default "relevance") — Sort order (the site's own six). The site always lists in-stock products first, then out-of-stock ones, each group in this order. For walking a whole category use name_asc (measured: 1,009 of 1,009 products, no page overlap). [one of: relevance, price_asc, price_desc, name_asc, name_desc, rating_desc]
- `page` (integer, optional, default 1) — Page number, 1-based. `total_pages` in the answer says how many there are.
- `page_size` (integer, optional, default 100) — Products per page, 1-100 (the site's own maximum; default 100).
- `store_id` (string, optional) — Game store code (G095 = Game Eastgate; `stores` lists all 96). Stock levels are that store's; prices are national (measured identical in 86 stores). Without store_id or an address the site's own default store G205 (Game Mall of Africa) is used and the answer says store_defaulted: true.
- `latitude` (number, optional) — Delivery address latitude (with longitude): the site maps the address to the Game store that serves it and that store's stock is returned (one extra request).
- `longitude` (number, optional) — Delivery address longitude (with latitude).
- `postal_code` (string, optional) — Optional South African postal code sent with latitude/longitude, as the site does.
- `include_facets` (boolean, optional, default true) — Return the filter counts (brands, price bands, sub-categories, promotions). false = lighter page (~35% fewer bytes) for whole-catalogue walks.

**Returns:** campaign, campaign_name, store_id, store_name, store_defaulted, location, total, total_pages, page, page_size, returned, sort, facets{brands[], price_ranges[], categories[], promotions[], ratings[]}, products[]{rank, product_id, title, brand, price, currency, original_price (was-price), savings, savings_percent, on_promotion, deals[]{promotion_id, text, quantity, deal_price, ends}, in_stock, stock_status, stock_level (units at store_id), stock_level_rounded, store_id, category_path[], tags[], online_only, clearance, store_only, pre_order, unit, image, images[], url}

**Example request body:**
```json
{
  "page_size": 24
}
```

### POST https://api.reefapi.com/game-za/v1/deal — 2 credits
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.

**Parameters:**
- `product_id` (string, required) — A product that carries the deal (its code or URL).
- `promotion_id` (string, required) — deals[].promotion_id from a product or listing row.
- `store_id` (string, optional) — Game store code (G095 = Game Eastgate; `stores` lists all 96). Stock levels are that store's; prices are national (measured identical in 86 stores). Without store_id or an address the site's own default store G205 (Game Mall of Africa) is used and the answer says store_defaulted: true.
- `latitude` (number, optional) — Delivery address latitude (with longitude): the site maps the address to the Game store that serves it and that store's stock is returned (one extra request).
- `longitude` (number, optional) — Delivery address longitude (with latitude).
- `postal_code` (string, optional) — Optional South African postal code sent with latitude/longitude, as the site does.

**Returns:** promotion_id, name, text, starts, ends, quantity, deal_price, product_ids[], store_id, store_defaulted, products[]{rank, product_id, title, brand, price, currency, original_price (was-price), savings, savings_percent, on_promotion, deals[]{promotion_id, text, quantity, deal_price, ends}, in_stock, stock_status, stock_level (units at store_id), stock_level_rounded, store_id, category_path[], tags[], online_only, clearance, store_only, pre_order, unit, image, images[], url}

**Example request body:**
```json
{
  "product_id": "000000000000130293",
  "promotion_id": "000001084201"
}
```

### POST https://api.reefapi.com/game-za/v1/categories — 1 credit
Game's category tree (15 departments, ~93 sub-departments, ~560 leaf categories) with the ids `category` and `search` take; or one department's subtree.

**Parameters:**
- `category_id` (string, optional) — Only this category and everything under it.

**Returns:** total_categories, levels{1,2,3}, categories[]{category_id, name, level, parent_ids[], path[], url}

**Example request body:**
```json
{
  "category_id": "G103"
}
```

### POST https://api.reefapi.com/game-za/v1/stores — 1 credit
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.

**Parameters:**
- `latitude` (number, optional) — Sort stores by distance from this point (with longitude).
- `longitude` (number, optional) — Longitude of the point.
- `province` (string, optional) — Only stores in this province: code (GP, WC, KN, EC, FS, LP, MP, NW, NC) or name (Gauteng …).
- `store_id` (string, optional) — Only this store.
- `limit` (integer, optional, default 100) — At most this many stores (default all).

**Returns:** total, returned, location, stores[]{store_id, name, address, formatted_address, town, postal_code, province, province_code, latitude, longitude, distance_km, phone, fax, email, manager, hours{monday … sunday: 'HH:MM-HH:MM' | null}, special_hours[], hours_text, parking, entrance, collection_estimate, url}

**Example request body:**
```json
{
  "province": "WC"
}
```

### POST https://api.reefapi.com/game-za/v1/locate_store — 1 credit
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.

**Parameters:**
- `latitude` (number, required) — Address latitude (South Africa).
- `longitude` (number, required) — Address longitude.
- `postal_code` (string, optional) — Optional South African postal code sent with latitude/longitude, as the site does.

**Returns:** location, store_id, store{…same as stores[]}, distance_km

**Example request body:**
```json
{
  "latitude": -33.9249,
  "longitude": 18.4241
}
```

### POST https://api.reefapi.com/game-za/v1/suggest — 1 credit
The site's search-as-you-type: up to 10 product suggestions with price and the matching categories for a partial word.

**Parameters:**
- `query` (string, required) — Partial search text (2+ characters).
- `store_id` (string, optional) — Game store code (G095 = Game Eastgate; `stores` lists all 96). Stock levels are that store's; prices are national (measured identical in 86 stores). Without store_id or an address the site's own default store G205 (Game Mall of Africa) is used and the answer says store_defaulted: true.

**Returns:** query, products[]{product_id, title, price, image, url}, categories[]{category_id, name}

**Example request body:**
```json
{
  "query": "samsung"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=game-za
- Human docs page: https://reefapi.com/docs/game-za
- Overview page: https://reefapi.com/game-za-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
