# Kmart Australia API — kmart.com.au search, product prices and barcodes, stock per store, marketplace offers, reviews, stores

> Keyword search on kmart.com.au (AUD, GST included): Kmart's own range, Target and Officeworks products and marketplace shops. Every row is the full product record with all variants. Filter by brand, colour, size, seller type, marketplace shop, price range, per-state availability, clearance, online-only, OnePass and any other facet; four sorts; up to 200 rows per page.
> ReefAPI engine `kmart` · 20 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/kmart/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/kmart/v1/search — 1 credit
Keyword search on kmart.com.au (AUD, GST included): Kmart's own range, Target and Officeworks products and marketplace shops. Every row is the full product record with all variants. Filter by brand, colour, size, seller type, marketplace shop, price range, per-state availability, clearance, online-only, OnePass and any other facet; four sorts; up to 200 rows per page.

**Parameters:**
- `query` (string, required) — Search words, e.g. `air fryer`, `bath towel`, `lego`.
- `category_id` (string, optional) — Narrow to one category: its 32-character id (from `categories`, `category_facet` or a product's `category_ids`) or its kmart.com.au link.
- `brand` (array, optional) — Brand name(s) exactly as Kmart lists them in the `Brand` facet (e.g. Anko, Philips). Several: comma-separated (any of them). A wrong letter case is corrected; an unknown brand returns INVALID_PARAM with the closest names.
- `colour` (array, optional) — Colour facet value(s) (e.g. Blue, White). Matches products with ANY variant in that colour.
- `size` (array, optional) — Size facet value(s) (e.g. M, 10, King Bed). Matches products with any variant in that size.
- `seller_type` (array, optional) — Who sells it: kmart, target, marketplace (third-party shops), officeworks. Several: comma-separated.
- `shop` (string, optional) — One marketplace shop by its display name (the `Shops` facet, e.g. ABM Global, Target).
- `min_price` (number, optional) — Lowest price in AUD (inclusive).
- `max_price` (number, optional) — Highest price in AUD (inclusive).
- `state` (string, optional) — Only products Kmart marks available in this Australian state: NSW, VIC, QLD, WA, SA, TAS, ACT, NT. [one of: NSW, VIC, QLD, WA, SA, TAS, ACT, NT]
- `clearance` (boolean, optional, default false) — Only clearance products.
- `online_only` (boolean, optional, default false) — Only products sold online only.
- `onepass` (boolean, optional, default false) — Only products eligible for OnePass (free delivery membership).
- `facets` (object, optional) — Any other facet of the listing, as {facet name: value or [values]} with names and values exactly as returned in `facets` (e.g. {"Material": "Cotton", "Product Type": "Bath Towel", "Gender": "Girls"}).
- `sort` (enum, optional, default "popular") — Result order — the site's four sorts. [one of: popular, new, price_asc, price_desc]
- `page` (integer, optional, default 1) — Result page (1-based). Kmart's catalogue serves the first 10,000 rows of any list; page × page_size past that is refused.
- `page_size` (integer, optional, default 40) — Rows per page, 1-200 (the site's own grid shows 40).

**Returns:** results[]{position, product_id (keycode), variant_id, title, brand, url, gtin, price_aud, was_price_aud, was_label, discount_pct_computed, price_min_aud, price_max_aud, currency, price_events[]{type, amount_aud, start_date, end_date, active}, sale_effective_at, clearance, badges[], pricing_badges[], labels[], seller_types[], sold_by{shop_id, label, kind}, offers[]{offer_id, shop_id, shop_name, seller_type, price_aud, discount_price_aud, quantity, cheapest_offer, fastest_delivery, onepass_eligible}, out_of_stock_states[], rating, review_count, colour, secondary_colour, size, image, images[], description, free_shipping, free_shipping_metro, fulfilment_channel, pre_order, merch_class, primary_category_id, category_ids[], variant_count, variants[]{variant_id, gtin, size, colour, price_aud, price_events[], clearance, out_of_stock_states[], badges[], image, images[], offers[]}} + count + page + page_size + total + total_capped + reachable_total + has_more + page_beyond_last + matched_by_text + matched_by_meaning + facets[]{name, label, type, options[]{value, label, count}} + availability_by_state{NSW:{available, not_available}, …} + category_facet[] + sort_options[] + related_searches[] + redirect + filters_applied + query

**Example request body:**
```json
{
  "query": "air fryer"
}
```

### POST https://api.reefapi.com/kmart/v1/category — 1 credit
One Kmart category (by id or kmart.com.au link, e.g. /home-and-living/ or /category/home-and-living/bath-towels/) or one curated collection (/collection/<slug>/), with the same rows, filters, sorts and paging as `search`. `all` lists the whole catalogue.

**Parameters:**
- `category_id` (string, optional) — 32-character category id, `all`, or a category link. Give this OR `collection`.
- `collection` (string, optional) — Collection slug or /collection/<slug>/ link. Give this OR `category_id`.
- `brand` (array, optional) — Brand name(s) exactly as Kmart lists them in the `Brand` facet (e.g. Anko, Philips). Several: comma-separated (any of them). A wrong letter case is corrected; an unknown brand returns INVALID_PARAM with the closest names.
- `colour` (array, optional) — Colour facet value(s) (e.g. Blue, White). Matches products with ANY variant in that colour.
- `size` (array, optional) — Size facet value(s) (e.g. M, 10, King Bed). Matches products with any variant in that size.
- `seller_type` (array, optional) — Who sells it: kmart, target, marketplace (third-party shops), officeworks. Several: comma-separated.
- `shop` (string, optional) — One marketplace shop by its display name (the `Shops` facet, e.g. ABM Global, Target).
- `min_price` (number, optional) — Lowest price in AUD (inclusive).
- `max_price` (number, optional) — Highest price in AUD (inclusive).
- `state` (string, optional) — Only products Kmart marks available in this Australian state: NSW, VIC, QLD, WA, SA, TAS, ACT, NT. [one of: NSW, VIC, QLD, WA, SA, TAS, ACT, NT]
- `clearance` (boolean, optional, default false) — Only clearance products.
- `online_only` (boolean, optional, default false) — Only products sold online only.
- `onepass` (boolean, optional, default false) — Only products eligible for OnePass (free delivery membership).
- `facets` (object, optional) — Any other facet of the listing, as {facet name: value or [values]} with names and values exactly as returned in `facets` (e.g. {"Material": "Cotton", "Product Type": "Bath Towel", "Gender": "Girls"}).
- `sort` (enum, optional, default "popular") — Result order — the site's four sorts. [one of: popular, new, price_asc, price_desc]
- `page` (integer, optional, default 1) — Result page (1-based). Kmart's catalogue serves the first 10,000 rows of any list; page × page_size past that is refused.
- `page_size` (integer, optional, default 40) — Rows per page, 1-200 (the site's own grid shows 40).

**Returns:** results[]{position, product_id (keycode), variant_id, title, brand, url, gtin, price_aud, was_price_aud, was_label, discount_pct_computed, price_min_aud, price_max_aud, currency, price_events[]{type, amount_aud, start_date, end_date, active}, sale_effective_at, clearance, badges[], pricing_badges[], labels[], seller_types[], sold_by{shop_id, label, kind}, offers[]{offer_id, shop_id, shop_name, seller_type, price_aud, discount_price_aud, quantity, cheapest_offer, fastest_delivery, onepass_eligible}, out_of_stock_states[], rating, review_count, colour, secondary_colour, size, image, images[], description, free_shipping, free_shipping_metro, fulfilment_channel, pre_order, merch_class, primary_category_id, category_ids[], variant_count, variants[]{variant_id, gtin, size, colour, price_aud, price_events[], clearance, out_of_stock_states[], badges[], image, images[], offers[]}} + count + page + page_size + total + total_capped + reachable_total + has_more + page_beyond_last + matched_by_text + matched_by_meaning + facets[]{name, label, type, options[]{value, label, count}} + availability_by_state{NSW:{available, not_available}, …} + category_facet[] + sort_options[] + related_searches[] + redirect + filters_applied + category{category_id, name, url} + collection{collection_id, name}

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

### POST https://api.reefapi.com/kmart/v1/brand_products — 1 credit
Every product of one brand, with the same filters, sorts and paging as `search`.

**Parameters:**
- `brand` (string, required) — Brand name as Kmart lists it (see `brands`). Letter case is corrected.
- `category_id` (string, optional) — Narrow to one category: its 32-character id (from `categories`, `category_facet` or a product's `category_ids`) or its kmart.com.au link.
- `colour` (array, optional) — Colour facet value(s) (e.g. Blue, White). Matches products with ANY variant in that colour.
- `size` (array, optional) — Size facet value(s) (e.g. M, 10, King Bed). Matches products with any variant in that size.
- `seller_type` (array, optional) — Who sells it: kmart, target, marketplace (third-party shops), officeworks. Several: comma-separated.
- `shop` (string, optional) — One marketplace shop by its display name (the `Shops` facet, e.g. ABM Global, Target).
- `min_price` (number, optional) — Lowest price in AUD (inclusive).
- `max_price` (number, optional) — Highest price in AUD (inclusive).
- `state` (string, optional) — Only products Kmart marks available in this Australian state: NSW, VIC, QLD, WA, SA, TAS, ACT, NT. [one of: NSW, VIC, QLD, WA, SA, TAS, ACT, NT]
- `clearance` (boolean, optional, default false) — Only clearance products.
- `online_only` (boolean, optional, default false) — Only products sold online only.
- `onepass` (boolean, optional, default false) — Only products eligible for OnePass (free delivery membership).
- `facets` (object, optional) — Any other facet of the listing, as {facet name: value or [values]} with names and values exactly as returned in `facets` (e.g. {"Material": "Cotton", "Product Type": "Bath Towel", "Gender": "Girls"}).
- `sort` (enum, optional, default "popular") — Result order — the site's four sorts. [one of: popular, new, price_asc, price_desc]
- `page` (integer, optional, default 1) — Result page (1-based). Kmart's catalogue serves the first 10,000 rows of any list; page × page_size past that is refused.
- `page_size` (integer, optional, default 40) — Rows per page, 1-200 (the site's own grid shows 40).

**Returns:** results[]{position, product_id (keycode), variant_id, title, brand, url, gtin, price_aud, was_price_aud, was_label, discount_pct_computed, price_min_aud, price_max_aud, currency, price_events[]{type, amount_aud, start_date, end_date, active}, sale_effective_at, clearance, badges[], pricing_badges[], labels[], seller_types[], sold_by{shop_id, label, kind}, offers[]{offer_id, shop_id, shop_name, seller_type, price_aud, discount_price_aud, quantity, cheapest_offer, fastest_delivery, onepass_eligible}, out_of_stock_states[], rating, review_count, colour, secondary_colour, size, image, images[], description, free_shipping, free_shipping_metro, fulfilment_channel, pre_order, merch_class, primary_category_id, category_ids[], variant_count, variants[]{variant_id, gtin, size, colour, price_aud, price_events[], clearance, out_of_stock_states[], badges[], image, images[], offers[]}} + count + page + page_size + total + total_capped + reachable_total + has_more + page_beyond_last + matched_by_text + matched_by_meaning + facets[]{name, label, type, options[]{value, label, count}} + availability_by_state{NSW:{available, not_available}, …} + category_facet[] + sort_options[] + related_searches[] + redirect + filters_applied + brand

**Example request body:**
```json
{
  "brand": "Anko"
}
```

### POST https://api.reefapi.com/kmart/v1/seller_products — 2 credits
Every product one marketplace shop sells on kmart.com.au (Target, Officeworks, ABM Global, …), with the same filters, sorts and paging as `search`.

**Parameters:**
- `seller` (string, required) — The shop's name (ABM Global), slug (abm-global), id (2039) or /shop/<slug>/ link.
- `category_id` (string, optional) — Narrow to one category: its 32-character id (from `categories`, `category_facet` or a product's `category_ids`) or its kmart.com.au link.
- `brand` (array, optional) — Brand name(s) exactly as Kmart lists them in the `Brand` facet (e.g. Anko, Philips). Several: comma-separated (any of them). A wrong letter case is corrected; an unknown brand returns INVALID_PARAM with the closest names.
- `colour` (array, optional) — Colour facet value(s) (e.g. Blue, White). Matches products with ANY variant in that colour.
- `size` (array, optional) — Size facet value(s) (e.g. M, 10, King Bed). Matches products with any variant in that size.
- `seller_type` (array, optional) — Who sells it: kmart, target, marketplace (third-party shops), officeworks. Several: comma-separated.
- `min_price` (number, optional) — Lowest price in AUD (inclusive).
- `max_price` (number, optional) — Highest price in AUD (inclusive).
- `state` (string, optional) — Only products Kmart marks available in this Australian state: NSW, VIC, QLD, WA, SA, TAS, ACT, NT. [one of: NSW, VIC, QLD, WA, SA, TAS, ACT, NT]
- `clearance` (boolean, optional, default false) — Only clearance products.
- `online_only` (boolean, optional, default false) — Only products sold online only.
- `onepass` (boolean, optional, default false) — Only products eligible for OnePass (free delivery membership).
- `facets` (object, optional) — Any other facet of the listing, as {facet name: value or [values]} with names and values exactly as returned in `facets` (e.g. {"Material": "Cotton", "Product Type": "Bath Towel", "Gender": "Girls"}).
- `sort` (enum, optional, default "popular") — Result order — the site's four sorts. [one of: popular, new, price_asc, price_desc]
- `page` (integer, optional, default 1) — Result page (1-based). Kmart's catalogue serves the first 10,000 rows of any list; page × page_size past that is refused.
- `page_size` (integer, optional, default 40) — Rows per page, 1-200 (the site's own grid shows 40).

**Returns:** results[]{position, product_id (keycode), variant_id, title, brand, url, gtin, price_aud, was_price_aud, was_label, discount_pct_computed, price_min_aud, price_max_aud, currency, price_events[]{type, amount_aud, start_date, end_date, active}, sale_effective_at, clearance, badges[], pricing_badges[], labels[], seller_types[], sold_by{shop_id, label, kind}, offers[]{offer_id, shop_id, shop_name, seller_type, price_aud, discount_price_aud, quantity, cheapest_offer, fastest_delivery, onepass_eligible}, out_of_stock_states[], rating, review_count, colour, secondary_colour, size, image, images[], description, free_shipping, free_shipping_metro, fulfilment_channel, pre_order, merch_class, primary_category_id, category_ids[], variant_count, variants[]{variant_id, gtin, size, colour, price_aud, price_events[], clearance, out_of_stock_states[], badges[], image, images[], offers[]}} + count + page + page_size + total + total_capped + reachable_total + has_more + page_beyond_last + matched_by_text + matched_by_meaning + facets[]{name, label, type, options[]{value, label, count}} + availability_by_state{NSW:{available, not_available}, …} + category_facet[] + sort_options[] + related_searches[] + redirect + filters_applied + seller{shop_id, slug, name, url}

**Example request body:**
```json
{
  "seller": "abm-global"
}
```

### POST https://api.reefapi.com/kmart/v1/specials — 3 credits
Kmart's special listings: clearance, online-only, OnePass-eligible, or new arrivals (newest first), store-wide or inside one category, with the same filters and paging as `search`.

**Parameters:**
- `type` (enum, optional, default "clearance") — Which special listing. [one of: clearance, online_only, onepass, new]
- `category_id` (string, optional) — Narrow to one category: its 32-character id (from `categories`, `category_facet` or a product's `category_ids`) or its kmart.com.au link.
- `brand` (array, optional) — Brand name(s) exactly as Kmart lists them in the `Brand` facet (e.g. Anko, Philips). Several: comma-separated (any of them). A wrong letter case is corrected; an unknown brand returns INVALID_PARAM with the closest names.
- `colour` (array, optional) — Colour facet value(s) (e.g. Blue, White). Matches products with ANY variant in that colour.
- `size` (array, optional) — Size facet value(s) (e.g. M, 10, King Bed). Matches products with any variant in that size.
- `seller_type` (array, optional) — Who sells it: kmart, target, marketplace (third-party shops), officeworks. Several: comma-separated.
- `shop` (string, optional) — One marketplace shop by its display name (the `Shops` facet, e.g. ABM Global, Target).
- `min_price` (number, optional) — Lowest price in AUD (inclusive).
- `max_price` (number, optional) — Highest price in AUD (inclusive).
- `state` (string, optional) — Only products Kmart marks available in this Australian state: NSW, VIC, QLD, WA, SA, TAS, ACT, NT. [one of: NSW, VIC, QLD, WA, SA, TAS, ACT, NT]
- `facets` (object, optional) — Any other facet of the listing, as {facet name: value or [values]} with names and values exactly as returned in `facets` (e.g. {"Material": "Cotton", "Product Type": "Bath Towel", "Gender": "Girls"}).
- `sort` (enum, optional, default "popular") — Result order — the site's four sorts. [one of: popular, new, price_asc, price_desc]
- `page` (integer, optional, default 1) — Result page (1-based). Kmart's catalogue serves the first 10,000 rows of any list; page × page_size past that is refused.
- `page_size` (integer, optional, default 40) — Rows per page, 1-200 (the site's own grid shows 40).

**Returns:** results[]{position, product_id (keycode), variant_id, title, brand, url, gtin, price_aud, was_price_aud, was_label, discount_pct_computed, price_min_aud, price_max_aud, currency, price_events[]{type, amount_aud, start_date, end_date, active}, sale_effective_at, clearance, badges[], pricing_badges[], labels[], seller_types[], sold_by{shop_id, label, kind}, offers[]{offer_id, shop_id, shop_name, seller_type, price_aud, discount_price_aud, quantity, cheapest_offer, fastest_delivery, onepass_eligible}, out_of_stock_states[], rating, review_count, colour, secondary_colour, size, image, images[], description, free_shipping, free_shipping_metro, fulfilment_channel, pre_order, merch_class, primary_category_id, category_ids[], variant_count, variants[]{variant_id, gtin, size, colour, price_aud, price_events[], clearance, out_of_stock_states[], badges[], image, images[], offers[]}} + count + page + page_size + total + total_capped + reachable_total + has_more + page_beyond_last + matched_by_text + matched_by_meaning + facets[]{name, label, type, options[]{value, label, count}} + availability_by_state{NSW:{available, not_available}, …} + category_facet[] + sort_options[] + related_searches[] + redirect + filters_applied + type

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

### POST https://api.reefapi.com/kmart/v1/product — 1 credit
The full Kmart product record for one keycode or up to 100 keycodes in ONE request: title, brand, GTIN/barcode, price, the site's WAS label and computed discount, price-event history, sale start, badges, seller and every marketplace offer, per-state out-of-stock flags, rating and review count, description, images, video, delivery flags, category ids and every variant (size / colour, own GTIN, price, images, offers).

**Parameters:**
- `product_id` (string, optional) — Kmart keycode — 8 digits for Kmart's own range (42442493), S + digits for marketplace / partner listings — or a kmart.com.au product link (/product/<name>-<keycode>/).
- `product_ids` (array, optional) — Several keycodes (or product links), comma-separated, answered in ONE request.
- `category_names` (boolean, optional, default false) — Also name the product's categories (one extra cached request for Kmart's category tree).

**Returns:** product{…same fields as a search row…, categories[]{category_id, name, url, depth}} for one id; products[] + count + missing[] for several

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

### POST https://api.reefapi.com/kmart/v1/reviews — 1 credit
Customer reviews of one product as Kmart publishes them: rating, title, text, date, reviewer display name, verified-buyer flag, helpful votes, the Value / Quality sub-ratings, photos, Kmart's reply; plus the average, total and star distribution. Sort and filter by star; up to 150 per page.

**Parameters:**
- `product_id` (string, optional) — Kmart keycode — 8 digits for Kmart's own range (42442493), S + digits for marketplace / partner listings — or a kmart.com.au product link (/product/<name>-<keycode>/).
- `sort` (enum, optional, default "newest") — Review order. [one of: newest, oldest, helpful, highest, lowest, with_images]
- `rating` (integer, optional) — Only reviews with this star rating (1-5).
- `page` (integer, optional, default 1) — Review page (1-based).
- `page_size` (integer, optional, default 10) — Reviews per page, 1-150 (the source's own maximum).

**Returns:** reviews[]{review_id, rating, title, text, created_at, author, author_id, verified_buyer, votes_up, votes_down, sentiment, ratings{Value, Quality}, images[], store_reply, incentivized, language} + count + page + page_size + total + has_more + summary{average_rating, review_count, star_distribution, aspect_ratings} + product{product_id, title, image, yotpo_id, url}

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

### POST https://api.reefapi.com/kmart/v1/autocomplete — 1 credit
Kmart's search-box suggestions for a partial term: suggested searches with their result count and categories, plus matching products.

**Parameters:**
- `query` (string, required) — What the shopper has typed so far.
- `suggestions` (integer, optional, default 10) — How many search suggestions (0-20).
- `products` (integer, optional, default 6) — How many product suggestions (0-20).

**Returns:** suggestions[]{term, result_count, image, categories[]{category_id, name, path}} + products[]{…product row…} + query

**Example request body:**
```json
{
  "query": "air fr"
}
```

### POST https://api.reefapi.com/kmart/v1/bestsellers — 1 credit
Kmart's best-seller list (the site's own Best Sellers pod), store-wide or for one category, optionally only products available in one state or sold by one seller type.

**Parameters:**
- `category_id` (string, optional) — Narrow to one category: its 32-character id (from `categories`, `category_facet` or a product's `category_ids`) or its kmart.com.au link.
- `state` (string, optional) — Only products Kmart marks available in this Australian state: NSW, VIC, QLD, WA, SA, TAS, ACT, NT. [one of: NSW, VIC, QLD, WA, SA, TAS, ACT, NT]
- `seller_type` (array, optional) — Who sells it: kmart, target, marketplace (third-party shops), officeworks. Several: comma-separated.
- `limit` (integer, optional, default 20) — How many products (1-100).

**Returns:** results[]{…product row…} + count + pod{id, name} + category_id

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

### POST https://api.reefapi.com/kmart/v1/related — 2 credits
"You may also like" products Kmart recommends on a product page, available for a postcode; scope to Kmart's range, Target, marketplace or all sellers.

**Parameters:**
- `product_id` (string, optional) — Kmart keycode — 8 digits for Kmart's own range (42442493), S + digits for marketplace / partner listings — or a kmart.com.au product link (/product/<name>-<keycode>/).
- `postcode` (string, optional, default "2000") — Australian postcode the answer is computed for (4 digits). Default 2000 (Sydney), the site's own default for a logged-out visitor.
- `scope` (enum, optional, default "all") — Which sellers to recommend. [one of: all, kmart, target, marketplace, kmart_target]
- `limit` (integer, optional, default 12) — How many recommendations to ask for (1-24).

**Returns:** product{product_id, title} + fallback (Kmart's 'customers also viewed' fallback list) + results[]{…product row…, score} + count

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

### POST https://api.reefapi.com/kmart/v1/availability — 2 credits
Live stock of one product for one postcode: whether home delivery is available, click & collect units in total and at the 3 nearest Kmart stores (store, distance, units — Kmart answers 3 stores, whatever is asked), in-store units and express delivery. Change the postcode to read another area.

**Parameters:**
- `product_id` (string, optional) — Kmart keycode — 8 digits for Kmart's own range (42442493), S + digits for marketplace / partner listings — or a kmart.com.au product link (/product/<name>-<keycode>/).
- `postcode` (string, optional, default "2000") — Australian postcode the answer is computed for (4 digits). Default 2000 (Sydney), the site's own default for a logged-out visitor.

**Returns:** product_id + postcode + region + home_delivery{available (1 = deliverable to the postcode, 0 = not), pool} + click_and_collect{total_available_qty, stores[]{store_id, store_name, distance_km, available_qty, buddy_store}} + in_store{stores[]{store_id, available_qty}} + express_delivery{available, store_id} + title / url / sold_by (filled when every count is 0 and the catalogue is read to tell a sold-out product from an unknown keycode)

**Example request body:**
```json
{
  "product_id": "42442493",
  "postcode": "3000"
}
```

### POST https://api.reefapi.com/kmart/v1/offers — 2 credits
Every marketplace offer for up to 20 products in ONE request, for one postcode: shop, price, discount and its dates, units in stock, OnePass, and each shipping option with its price and delivery window in days. Kmart's own range has no marketplace offers.

**Parameters:**
- `product_id` (string, optional) — Kmart keycode — 8 digits for Kmart's own range (42442493), S + digits for marketplace / partner listings — or a kmart.com.au product link (/product/<name>-<keycode>/).
- `product_ids` (array, optional) — Several keycodes (or product links), comma-separated, answered in ONE request.
- `postcode` (string, optional, default "2000") — Australian postcode the answer is computed for (4 digits). Default 2000 (Sydney), the site's own default for a logged-out visitor.

**Returns:** products[]{product_id, offer_count, lowest_price_aud, offers[]{offer_id, shop_id, shop_name, price_aud, discount_price_aud, discount_amount_aud, discount_start, discount_end, quantity, onepass_enabled, bulky, warehouse, shipping_options[]{type, label, price_aud, earliest_days, latest_days}}} + postcode + without_offers[]

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

### POST https://api.reefapi.com/kmart/v1/categories — 0 credits
Kmart's category tree with product counts: the top level, or the children of one category, down to a chosen depth.

**Parameters:**
- `parent` (string, optional) — A category id or link whose sub-categories to list; empty = the top level.
- `depth` (integer, optional, default 1) — How many levels below the parent (1-4).

**Returns:** categories[]{category_id, name, product_count, url, parent_id, depth, path[], has_children} + parent + parent_name + total_products + count

**Example request body:**
```json
{
  "parent": "dddaa894234df841cfb678463562e055"
}
```

### POST https://api.reefapi.com/kmart/v1/brands — 1 credit
Brands Kmart lists, with how many products each has — store-wide or inside one category, optionally filtered by a name fragment.

**Parameters:**
- `category_id` (string, optional) — Narrow to one category: its 32-character id (from `categories`, `category_facet` or a product's `category_ids`) or its kmart.com.au link.
- `query` (string, optional) — Keep brands whose name contains this text.

**Returns:** brands[]{name, product_count} + count + category_id

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

### POST https://api.reefapi.com/kmart/v1/sellers — 2 credits
Every shop selling on kmart.com.au (Kmart, Target, Officeworks and the marketplace shops): id, slug, name, logo, OnePass and marketplace flags.

**Parameters:**
- `query` (string, optional) — Keep shops whose name contains this text.
- `product_counts` (boolean, optional, default false) — Add each shop's product count from the catalogue (one more request).

**Returns:** sellers[]{shop_id, slug, name, url, logo, priority, onepass_shop, marketplace_shop, features[], product_count} + count

### POST https://api.reefapi.com/kmart/v1/seller — 2 credits
One marketplace shop: name, description, shipping policy, logo, OnePass and marketplace flags, and on request how many products it lists.

**Parameters:**
- `seller` (string, required) — Shop slug (abm-global), name (ABM Global), id (2039) or /shop/<slug>/ link.
- `product_count` (boolean, optional, default false) — Also count the shop's products in the catalogue (one more request).

**Returns:** seller{shop_id, slug, name, url, logo, description, shipping_policy, onepass_shop, marketplace_shop, features[], product_count (with product_count=true)}

**Example request body:**
```json
{
  "seller": "abm-global"
}
```

### POST https://api.reefapi.com/kmart/v1/stores — 2 credits
Kmart's store directory (Australia by default; New Zealand on request): address, phone, coordinates, click & collect, trading hours. Filter by state, by a text match, or list the stores nearest a point.

**Parameters:**
- `state` (string, optional) — AU state (NSW, VIC, QLD, WA, SA, TAS, ACT, NT) or an NZ island (North Island, South Island).
- `country` (enum, optional, default "au") [one of: au, nz, all]
- `query` (string, optional) — Keep stores whose name, city, address or postcode contains this text.
- `latitude` (number, optional) — With `longitude`: list stores nearest this point, closest first.
- `longitude` (number, optional)
- `radius_km` (number, optional, default 50) — Search radius around the point, km.
- `click_and_collect_only` (boolean, optional, default false) — Only stores offering click & collect.

**Returns:** stores[]{store_id, name, address, address_lines[], city, state, postcode, country, phone, latitude, longitude, click_and_collect, distance_km, trading_hours[]{day, hours}} + count + total

**Example request body:**
```json
{
  "state": "VIC"
}
```

### POST https://api.reefapi.com/kmart/v1/store — 2 credits
One Kmart store: address, phone, coordinates and trading hours for each day.

**Parameters:**
- `store_id` (string, required) — Kmart store number (from `stores` or `availability`), or the store's name.

**Returns:** store{store_id, name, address, city, state, postcode, phone, latitude, longitude, trading_hours[]}

**Example request body:**
```json
{
  "store_id": "1384"
}
```

### POST https://api.reefapi.com/kmart/v1/postcodes — 2 credits
Kmart's postcode / suburb lookup: suburbs, state and whether the area is metro for free shipping.

**Parameters:**
- `query` (string, required) — A postcode or the start of a suburb name.

**Returns:** postcodes[]{postcode, suburb, state, metro_free_shipping} + count

**Example request body:**
```json
{
  "query": "air fryer"
}
```

### POST https://api.reefapi.com/kmart/v1/sitemap — 3 credits
kmart.com.au's own sitemaps: the index, or the links of one sitemap (every product, category, collection, marketplace shop, store or content page) with last-modified dates, paged.

**Parameters:**
- `type` (enum, optional, default "index") — Which sitemap. [one of: index, products, categories, collections, sellers, stores, content]
- `part` (string, optional) — For products: which part (a, b, c, … as listed in the index).
- `page` (integer, optional, default 1) — Page of links.
- `page_size` (integer, optional, default 500) — Links per page (1-5000).

**Returns:** index: sitemaps[]{url, lastmod, type, part}; otherwise links[]{url, lastmod, product_id | seller_slug | store_slug | collection_id} + total + page + page_size + has_more + sitemap

**Example request body:**
```json
{
  "part": "a"
}
```

## 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=kmart
- Human docs page: https://reefapi.com/docs/kmart
- Overview page: https://reefapi.com/kmart-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
