# JB Hi-Fi API — Australia & New Zealand electronics: search, categories, deals, prices, stock per store, reviews, stores

> Keyword search on JB Hi-Fi (jbhifi.com.au or jbhifi.co.nz) with the site's filters: brand, seller (JB Hi-Fi or marketplace), condition, price range, in stock, on sale, availability, tag, spec filters and category. Each row is one SKU (or a product family) with price, printed was-price, stock status, rating, seller and barcode. `total` is the site's own count; facets give counts per brand, seller, category, tag and price range.
> ReefAPI engine `jbhifi` · 13 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/jbhifi/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/jbhifi/v1/search — 1 credit
Keyword search on JB Hi-Fi (jbhifi.com.au or jbhifi.co.nz) with the site's filters: brand, seller (JB Hi-Fi or marketplace), condition, price range, in stock, on sale, availability, tag, spec filters and category. Each row is one SKU (or a product family) with price, printed was-price, stock status, rating, seller and barcode. `total` is the site's own count; facets give counts per brand, seller, category, tag and price range.

**Parameters:**
- `query` (string, required) — Search words, a model number or a barcode (e.g. airpods, 65 inch oled tv, MFHP4X/A).
- `category` (string, optional) — Narrow to a category: a category name from `category_path` / `facets.category` (e.g. Headphones, TVs LED) or a collection handle.
- `country` (enum, optional, default "au") — Which JB Hi-Fi: `au` = jbhifi.com.au (AUD), `nz` = jbhifi.co.nz (NZD). Also accepts `australia`, `new zealand`. A pasted link sets it automatically. [one of: au, nz]
- `sort` (enum, optional, default "relevance") — Result order. title_asc / title_desc work on au only (nz's title order does not sort). [one of: relevance, price_asc, price_desc, rating_desc, newest, oldest, title_asc, title_desc]
- `page` (integer, optional, default 1) — Result page (1-based). The site serves the first 12 000 results of a listing; pages past that return no rows (`page_beyond_window`).
- `page_size` (integer, optional, default 36) — Rows per page, 1-100.
- `brand` (string, optional) — Only this brand (as in `facets.brand[].value`, e.g. SONY, APPLE, SAMSUNG; not case-sensitive).
- `seller` (string, optional) — Only items sold by this seller (`facets.seller[].value`: JB Hi-Fi or a marketplace seller name).
- `condition` (enum, optional) — Item condition. [one of: new, as_new, excellent, very_good, good, refurbished, renewed]
- `price_min` (number, optional) — Lowest price (AUD / NZD, incl. GST).
- `price_max` (number, optional) — Highest price (AUD / NZD, incl. GST).
- `in_stock` (boolean, optional) — true = only In stock / Limited stock items; false = only items that are not.
- `on_sale` (boolean, optional) — true = only items on promotion; false = only items that are not.
- `availability` (enum, optional) — The site's Availability filter. [one of: available_now, awaiting_stock, coming_soon]
- `marketplace` (enum, optional, default "include") — JB Hi-Fi's own stock and marketplace sellers (`include`), only JB Hi-Fi's own (`exclude`) or only marketplace sellers (`only`). [one of: include, exclude, only]
- `tag` (string, optional) — Only items carrying this site tag (`facets.tag[].value`, e.g. Clearance, Red Hot Deal, Pre-Order, Online Only).
- `facet_filters` (array, optional) — Spec filters as `Name:Value` (names from `facets` of a category listing or `specifications[].name` of a product), e.g. `Screen Size (Inches):65`.

**Returns:** results[]{sku, id, is_family, family_id, title, subtitle, url, handle, brand, model, barcode, image, category, category_path[], department, product_group, price, price_ex_gst, gst, was_price, save_amount, discount_percent, shows_was_price, source_was_price, source_save_amount, ticket_price, cashback_amount, price_after_cashback, perks_price, currency, on_promotion, promotion_ends, price_badge, badge, promo_tags[], tags[], delivery_tag, free_delivery, availability{status, statement, delivery, click_and_collect, in_store, can_buy_online, ...}, in_stock_store_count, display_model_store_count, rating, review_count, weighted_rating, seller{id, name}, is_marketplace, marketplace_offer_count, condition, release_date, published_at} + count + total + total_is_exact + page + page_size + total_pages + has_more + facets{brand[], seller[], condition[], department[], category[], subcategory[], stock_status[], badge[], tag[], availability[], ...} + price_range{min, max, avg} + country + query + sort

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

### POST https://api.reefapi.com/jbhifi/v1/suggestions — 1 credit
JB Hi-Fi's own search suggestions (autocomplete) for a partial query, with how often each suggestion is searched and how many records it matches.

**Parameters:**
- `query` (string, required) — The partial search text, e.g. `iph`.
- `country` (enum, optional, default "au") — Which JB Hi-Fi: `au` = jbhifi.com.au (AUD), `nz` = jbhifi.co.nz (NZD). Also accepts `australia`, `new zealand`. A pasted link sets it automatically. [one of: au, nz]
- `limit` (integer, optional, default 10) — How many suggestions.

**Returns:** suggestions[]{query, popularity, matching_records, matching_listed_records, words} + count

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

### POST https://api.reefapi.com/jbhifi/v1/product — 2 credits
One JB Hi-Fi product, everything the site publishes about it: title, brand, model, barcodes, all price lines (price, printed was-price, ticket price, cashback, Perks price, price ex GST), stock status by channel (delivery, click & collect, in store), the stores holding stock, the full spec sheet, key features, description, images, promotions and offers with dates, marketplace sellers' offers, suppliers, packaged size and weight, Shopify variants, rating and review count, and for a colour/size family every member SKU with its price.

**Parameters:**
- `product` (string, required) — A SKU (`sku` of a listing row, e.g. 841227), a product handle (apple-airpods-pro-3), a family id (`family_id`, UUID) or a product link.
- `country` (enum, optional, default "au") — Which JB Hi-Fi: `au` = jbhifi.com.au (AUD), `nz` = jbhifi.co.nz (NZD). Also accepts `australia`, `new zealand`. A pasted link sets it automatically. [one of: au, nz]

**Returns:** product{every search row field + primary_title, sku_url, barcodes[], description, description_html, key_features[], specifications[]{name, value}, graphic_attributes[], images[], media[], offers_and_messages[]{type, subtype, tag, heading, description, starts, ends}, marketplace_offers[], category_id, suppliers[]{number, name, ean, stock_code}, packaged_dimensions_m{height, width, depth}, packaged_weight_kg, weight_grams, limit_per_order, freight_price, release_date_text, product_flags[], media_info, collections[], variants[]{variant_id, sku, price, barcode, weight_grams, available}, shopify_price, price_matches_shopify, in_stock_store_ids[], display_model_store_ids[], popularity_buckets, is_listed, family{family_id, title, options[], members[]{sku, title, url, options, price, was_price, stock_status}}, created_at, updated_at, price_updated_at}

**Example request body:**
```json
{
  "product": "841227"
}
```

### POST https://api.reefapi.com/jbhifi/v1/reviews — 2 credits
Customer reviews of one JB Hi-Fi product (Bazaarvoice, as shown on the product page): rating, title, text, nickname, date, recommended, Quality / Value sub-ratings, helpful votes, photos, JB Hi-Fi's replies, plus the product's rating statistics (average, 5-to-1 star counts, recommended count). Sort and filter by star rating; paged. (Measured 2026-11-16: no JB Hi-Fi review in an 8-product sample carried a photo, so there is no photo filter; `photos` is returned when present.)

**Parameters:**
- `product` (string, required) — A SKU (`sku` of a listing row, e.g. 841227), a product handle (apple-airpods-pro-3), a family id (`family_id`, UUID) or a product link.
- `country` (enum, optional, default "au") — Which JB Hi-Fi: `au` = jbhifi.com.au (AUD), `nz` = jbhifi.co.nz (NZD). Also accepts `australia`, `new zealand`. A pasted link sets it automatically. [one of: au, nz]
- `sort` (enum, optional, default "newest") — Review order. [one of: newest, oldest, rating_desc, rating_asc, helpful]
- `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 20) — Reviews per page, 1-100.

**Returns:** product{sku, title, url} + statistics{review_count, average_rating, rating_distribution{5..1}, recommended_count, not_recommended_count, secondary_rating_averages, first_review_at, last_review_at} + reviews[]{review_id, title, text, rating, author, submitted_at, is_recommended, secondary_ratings, helpful_votes, unhelpful_votes, photos[], client_responses[], is_syndicated, content_locale} + count + total + page + page_size + has_more

**Example request body:**
```json
{
  "product": "841227"
}
```

### POST https://api.reefapi.com/jbhifi/v1/stock — 1 credit
Which JB Hi-Fi stores hold stock of a product (and which have it on display), nearest first when you give a postcode, suburb or coordinates; with each store's address, phone, distance and services. Also counts warehouses and other non-shop locations that hold it.

**Parameters:**
- `product` (string, required) — A SKU (`sku` of a listing row, e.g. 841227), a product handle (apple-airpods-pro-3), a family id (`family_id`, UUID) or a product link.
- `country` (enum, optional, default "au") — Which JB Hi-Fi: `au` = jbhifi.com.au (AUD), `nz` = jbhifi.co.nz (NZD). Also accepts `australia`, `new zealand`. A pasted link sets it automatically. [one of: au, nz]
- `location` (string, optional) — Sort stores by distance from a postcode (3000), a suburb (Parramatta) or `lat,lng`.
- `radius_km` (number, optional) — Only stores within this many km of `location`.
- `state` (string, optional) — au only: only stores in this state (ACT, NSW, NT, QLD, SA, TAS, VIC, WA).
- `in_stock_only` (boolean, optional, default false) — true = only stores holding stock.
- `limit` (integer, optional, default 50) — How many store rows.

**Returns:** product{sku, title, url, availability} + location{label, latitude, longitude} + stores_with_stock + stores_total + other_locations_with_stock[]{store_id, name, type} + stores[]{store_id, name, type, in_stock, display_model, distance_km, address, phone, url, click_and_collect, in_store_purchase} + count

**Example request body:**
```json
{
  "product": "841227"
}
```

### POST https://api.reefapi.com/jbhifi/v1/deals — 1 credit
JB Hi-Fi deals: items on promotion, On Sale, Clearance, Red Hot Deal, Black Friday, JB Exclusive, Pre-Order, New at JB!, Refurbished and more — with the same filters, sort and paging as `search`, optionally narrowed by keyword or category.

**Parameters:**
- `deal_type` (enum, optional, default "any") — Which deals. [one of: any, on_sale, clearance, red_hot_deal, black_friday, jb_exclusive, new, pre_order, coming_soon, refurbished, bonus_offer, bundle_buy, buy_2_get_1_free, online_only, in_store_only]
- `query` (string, optional) — Optional search words inside the deals.
- `category` (string, optional) — Narrow to a category: a category name from `category_path` / `facets.category` (e.g. Headphones, TVs LED) or a collection handle.
- `country` (enum, optional, default "au") — Which JB Hi-Fi: `au` = jbhifi.com.au (AUD), `nz` = jbhifi.co.nz (NZD). Also accepts `australia`, `new zealand`. A pasted link sets it automatically. [one of: au, nz]
- `sort` (enum, optional, default "relevance") — Result order. title_asc / title_desc work on au only (nz's title order does not sort). [one of: relevance, price_asc, price_desc, rating_desc, newest, oldest, title_asc, title_desc]
- `page` (integer, optional, default 1) — Result page (1-based). The site serves the first 12 000 results of a listing; pages past that return no rows (`page_beyond_window`).
- `page_size` (integer, optional, default 36) — Rows per page, 1-100.
- `brand` (string, optional) — Only this brand (as in `facets.brand[].value`, e.g. SONY, APPLE, SAMSUNG; not case-sensitive).
- `seller` (string, optional) — Only items sold by this seller (`facets.seller[].value`: JB Hi-Fi or a marketplace seller name).
- `condition` (enum, optional) — Item condition. [one of: new, as_new, excellent, very_good, good, refurbished, renewed]
- `price_min` (number, optional) — Lowest price (AUD / NZD, incl. GST).
- `price_max` (number, optional) — Highest price (AUD / NZD, incl. GST).
- `in_stock` (boolean, optional) — true = only In stock / Limited stock items; false = only items that are not.
- `on_sale` (boolean, optional) — true = only items on promotion; false = only items that are not.
- `availability` (enum, optional) — The site's Availability filter. [one of: available_now, awaiting_stock, coming_soon]
- `marketplace` (enum, optional, default "include") — JB Hi-Fi's own stock and marketplace sellers (`include`), only JB Hi-Fi's own (`exclude`) or only marketplace sellers (`only`). [one of: include, exclude, only]
- `tag` (string, optional) — Only items carrying this site tag (`facets.tag[].value`, e.g. Clearance, Red Hot Deal, Pre-Order, Online Only).
- `facet_filters` (array, optional) — Spec filters as `Name:Value` (names from `facets` of a category listing or `specifications[].name` of a product), e.g. `Screen Size (Inches):65`.

**Returns:** same as search + deal_type

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

### POST https://api.reefapi.com/jbhifi/v1/categories — 0 credits
JB Hi-Fi's category menu as the site shows it (Products → Computers & Tablets → Laptops …, plus the Brands and Deals menus): every entry with its collection handle and link, and a flat list of all collections in the menu. Feed `collection` into `category`.

**Parameters:**
- `country` (enum, optional, default "au") — Which JB Hi-Fi: `au` = jbhifi.com.au (AUD), `nz` = jbhifi.co.nz (NZD). Also accepts `australia`, `new zealand`. A pasted link sets it automatically. [one of: au, nz]

**Returns:** menus[]{name, url, collection, icon, children[]} + collections[]{name, collection, url, trail[]} + count

### POST https://api.reefapi.com/jbhifi/v1/category — 1 credit
The products of one JB Hi-Fi category (collection) page, e.g. tvs or headphones-speakers-audio/headphones, exactly as the page lists them, with the page's own spec filters (screen size, resolution …) as `facets`, its sub-categories, breadcrumbs and featured SKUs, plus the same filters, sort and paging as `search`.

**Parameters:**
- `category` (string, required) — A collection handle (tvs, headphones-speakers-audio/headphones, from `categories` or `subcollections`) or a collection link.
- `query` (string, optional) — Optional search words inside the category.
- `country` (enum, optional, default "au") — Which JB Hi-Fi: `au` = jbhifi.com.au (AUD), `nz` = jbhifi.co.nz (NZD). Also accepts `australia`, `new zealand`. A pasted link sets it automatically. [one of: au, nz]
- `sort` (enum, optional, default "relevance") — Result order. title_asc / title_desc work on au only (nz's title order does not sort). [one of: relevance, price_asc, price_desc, rating_desc, newest, oldest, title_asc, title_desc]
- `page` (integer, optional, default 1) — Result page (1-based). The site serves the first 12 000 results of a listing; pages past that return no rows (`page_beyond_window`).
- `page_size` (integer, optional, default 36) — Rows per page, 1-100.
- `brand` (string, optional) — Only this brand (as in `facets.brand[].value`, e.g. SONY, APPLE, SAMSUNG; not case-sensitive).
- `seller` (string, optional) — Only items sold by this seller (`facets.seller[].value`: JB Hi-Fi or a marketplace seller name).
- `condition` (enum, optional) — Item condition. [one of: new, as_new, excellent, very_good, good, refurbished, renewed]
- `price_min` (number, optional) — Lowest price (AUD / NZD, incl. GST).
- `price_max` (number, optional) — Highest price (AUD / NZD, incl. GST).
- `in_stock` (boolean, optional) — true = only In stock / Limited stock items; false = only items that are not.
- `on_sale` (boolean, optional) — true = only items on promotion; false = only items that are not.
- `availability` (enum, optional) — The site's Availability filter. [one of: available_now, awaiting_stock, coming_soon]
- `marketplace` (enum, optional, default "include") — JB Hi-Fi's own stock and marketplace sellers (`include`), only JB Hi-Fi's own (`exclude`) or only marketplace sellers (`only`). [one of: include, exclude, only]
- `tag` (string, optional) — Only items carrying this site tag (`facets.tag[].value`, e.g. Clearance, Red Hot Deal, Pre-Order, Online Only).
- `facet_filters` (array, optional) — Spec filters as `Name:Value` (names from `facets` of a category listing or `specifications[].name` of a product), e.g. `Screen Size (Inches):65`.

**Returns:** category{collection, name, url, page_title, subcollections[], breadcrumbs[], facets[]{name, type}, featured_skus[], description, default_sort} + same rows / totals / facets as search

**Example request body:**
```json
{
  "category": "tvs"
}
```

### POST https://api.reefapi.com/jbhifi/v1/brands — 1 credit
Every brand JB Hi-Fi lists, with how many products each has, optionally inside one category or matching a text; sorted by product count or name, paged.

**Parameters:**
- `country` (enum, optional, default "au") — Which JB Hi-Fi: `au` = jbhifi.com.au (AUD), `nz` = jbhifi.co.nz (NZD). Also accepts `australia`, `new zealand`. A pasted link sets it automatically. [one of: au, nz]
- `category` (string, optional) — Narrow to a category: a category name from `category_path` / `facets.category` (e.g. Headphones, TVs LED) or a collection handle.
- `query` (string, optional) — Only brands whose name contains this text.
- `sort` (enum, optional, default "count") — Brand order. [one of: count, name]
- `page` (integer, optional, default 1) — Page.
- `page_size` (integer, optional, default 100) — Brands per page.

**Returns:** brands[]{name, product_count} + count + total + page + page_size + has_more + facet_values_capped

**Example request body:**
```json
{
  "category": "Headphones"
}
```

### POST https://api.reefapi.com/jbhifi/v1/stores — 0 credits
JB Hi-Fi stores (and JB Hi-Fi HOME stores): address, phone, coordinates, opening hours for the week, special trading hours, click & collect / delivery services and the categories each store ranges; nearest first from a postcode, suburb or coordinates, filter by state, type, radius or name.

**Parameters:**
- `country` (enum, optional, default "au") — Which JB Hi-Fi: `au` = jbhifi.com.au (AUD), `nz` = jbhifi.co.nz (NZD). Also accepts `australia`, `new zealand`. A pasted link sets it automatically. [one of: au, nz]
- `query` (string, optional) — Only stores whose name, suburb, postcode, state or address contains this text.
- `location` (string, optional) — Nearest first from a postcode, suburb or `lat,lng`.
- `radius_km` (number, optional) — Only stores within this many km of `location`.
- `state` (string, optional) — au only: one state.
- `type` (enum, optional, default "all") — Store type. [one of: all, store, home]
- `page` (integer, optional, default 1) — Page.
- `page_size` (integer, optional, default 20) — Stores per page.

**Returns:** stores[]{store_id, shop_id, name, type, url, address{line1, line2, line3, suburb, state, postcode, country}, phone, fax, latitude, longitude, distance_km, timezone, click_and_collect, in_store_purchase, delivery, delivery_services[], categories_ranged[], message, normal_trading_hours[], trading_hours_this_week[], trading_hour_changes[]} + count + total + page + page_size + has_more + location

**Example request body:**
```json
{
  "location": "3000"
}
```

### POST https://api.reefapi.com/jbhifi/v1/store — 0 credits
One JB Hi-Fi store: address, phone, coordinates, opening hours, this week's and special trading hours, services and ranged categories.

**Parameters:**
- `store` (string, required) — `store_id` from stores / stock, a store name or page slug (artarmon) or a store page link.
- `country` (enum, optional, default "au") — Which JB Hi-Fi: `au` = jbhifi.com.au (AUD), `nz` = jbhifi.co.nz (NZD). Also accepts `australia`, `new zealand`. A pasted link sets it automatically. [one of: au, nz]

**Returns:** store{same fields as a stores row}

**Example request body:**
```json
{
  "store": "131"
}
```

### POST https://api.reefapi.com/jbhifi/v1/sitemap — 0 credits
The site's own sitemap index: every product, collection, page, article and blog sitemap file (products: 110 files on au, 32 on nz), and the sub-collection sitemap.

**Parameters:**
- `country` (enum, optional, default "au") — Which JB Hi-Fi: `au` = jbhifi.com.au (AUD), `nz` = jbhifi.co.nz (NZD). Also accepts `australia`, `new zealand`. A pasted link sets it automatically. [one of: au, nz]
- `type` (enum, optional) — Only one kind of sitemap. [one of: products, collections, pages, articles, blogs, agentic, subcollections]

**Returns:** sitemaps[]{url, type, shard} + count + counts_by_type

### POST https://api.reefapi.com/jbhifi/v1/sitemap_products — 1 credit
One product sitemap file of JB Hi-Fi (about 1 000 product links each, with last-modified date, main image and title) — the way to walk the whole catalogue.

**Parameters:**
- `country` (enum, optional, default "au") — Which JB Hi-Fi: `au` = jbhifi.com.au (AUD), `nz` = jbhifi.co.nz (NZD). Also accepts `australia`, `new zealand`. A pasted link sets it automatically. [one of: au, nz]
- `page` (integer, optional, default 1) — Which product sitemap (1 = first; `total_pages` says how many).

**Returns:** products[]{url, handle, lastmod, image, title} + count + page + total_pages + has_more

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