JB Hi-Fi API & Scraper
JB Hi-Fi is Australia's and New Zealand's biggest consumer-electronics retailer.
🤖 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.
This API reads both sites as JSON, logged out: country=au for jbhifi.com.au in AUD, country=nz for jbhifi.co.nz in NZD. `search`, `category` and `deals` return one row per SKU with the price, the was-price exactly when the site prints one, the stock status for delivery, click & collect and in store, the rating and review count, the seller (JB Hi-Fi or a marketplace seller) and the barcode, filtered by brand, seller, condition, price range, in stock, on sale, availability, tag or any spec the category page offers (screen size, resolution...). The total is the site's own count. `product` adds the full spec sheet, description, key features, every image, promotions with their dates, suppliers, packaged size and weight, the ids of the stores holding stock and, for a colour or storage family, every member SKU with its price. `stock` lists the stores that hold a product, nearest first from a postcode. `reviews` returns the customer reviews and the 5-to-1 star counts. `stores` returns the store list with this week's opening hours.
What a JB Hi-Fi field actually contains
Fields that read differently from how they look. Every row was measured against live JB Hi-Fi pages on 2026-11-16.
| Field | What it holds |
|---|---|
| price | The price the product page shows, GST included, in AUD or NZD. It matched the product page on 22 of 22 products (20 Australian including 2 marketplace items, 2 New Zealand). |
| was_price, save_amount | The crossed-out "was" price and the saving, only when the page prints them. 7 of the 22 products printed one and all 7 matched; for the other 15 these are null. |
| source_was_price, shows_was_price | JB Hi-Fi's record can carry a was-price the page does not show (AirPods Pro 3: 300 stored, only $290 shown). source_was_price returns that stored number as it is; shows_was_price says whether the page prints it. |
| rating, review_count | The star average and review count shown under the product title. weighted_rating is a different number (3.59 against 4.06 for AirPods Pro 3) that JB Hi-Fi uses for its top-rated sort. |
| ticket_price | JB Hi-Fi's own ticket price for the item, returned as recorded; the product page does not print it. |
| store_id | The id stock lists and store pages use. For 139 of 267 Australian locations it differs from shop_id, which is returned beside it. |
| family.members | For a colour or storage family, every SKU in it with its own price and stock status (Apple iPhone 17: 9 SKUs across 256GB and 512GB). |
| total | The site's own result count for the listing. total_is_exact passes on the site's flag; listings serve the first 12,000 results. |
Prices include GST, in AUD for country=au and NZD for country=nz. New Zealand has 50 locations (27 listed shops); Australia has 267 (210 listed shops).
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/jbhifi/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "airpods"
}
}{
"ok": true,
"meta": {
"api": "jbhifi",
"endpoint": "search",
"mode": "live",
"latency_ms": 1283.3,
"record_count": 36,
"bytes": 114018,
"cache_hit": false,
"total": 109,
"upstream_requests": 1,
"charged_credits": 1,
"version": "0.1.0",
"request_id": "a04fca9b25be410f",
"queue_ms": 7.7,
"fetched_at": "2026-11-16T15:58:09.395Z"
},
"data": {
"country": "au",
"query": "airpods",
"sort": "relevance",
"filters_applied": {},
"results": [
{
"sku": "841227",
"id": "841227",
"is_family": false,
"family_id": null,
"title": "Apple AirPods Pro 3",
"subtitle": null,
"url": "https://www.jbhifi.com.au/products/apple-airpods-pro-3",
"handle": "apple-airpods-pro-3",
"brand": "APPLE",
"model": "MFHP4X/A",
"barcode": "195950754483",
"image": "https://cdn.shopify.com/s/files/1/0024/9803/5810/files/841227-Product-0-I-638930604606650237_8e9e1bfc-39e6-4e6c-80ba-b5fb5a862442.jpg?v=1759894145",
"category": "In-ear wireless headphones",
"category_path": [
"Headphones, Speakers & Audio",
"Headphones",
"In-ear headphones"
],
"department": "AUDIO",
"product_group": "HEADPHONES - TRUE WIRELESS",
"price": 290,
"price_ex_gst": 263.64,
"gst": 26.36,
"was_price": null,
"save_amount": null,
"discount_percent": null,
"shows_was_price": false,
"source_was_price": 300,
"source_save_amount": 10,
"ticket_price": 429,
"cashback_amount": 0,
"price_after_cashback": null,
"shows_price_after_cashback": false,
"perks_price": null,
"perks_was_price": null,
"perks_promotions": [],
"currency": "AUD",
"price_record_matches": true,
"on_promotion": false,
"promotion_ends": "2026-12-02T12:59:59+00:00",
"price_badge": "Red Hot Deal",
"badge": null,
"promo_tags": [
"TRADE IN YOUR OLD AIRPODS",
"Black Friday Deal"
],
"tags": [
"TRADE IN YOUR OLD AIRPODS",
"Black Friday Deal",
"Red Hot Deal"
],
"delivery_tag": null,
"free_delivery": false,
"button": "Buy",
"availability": {
"status": "InStock",
"statement": "In stock",
"available_now": "Available Now",
"delivery": "InStock",
"click_and_collect": "InStock",
"in_store": "InStock",
"can_buy_online": true,
"can_pre_order": false,
"delivery_only": false,
"online_warehouse_only": false,
"delivery_constraint": "CountryWide",
"fulfilment": "Physical",
"lifecycle": "NonReplenishable",
"displayed": true,
"hidden_by_family": false
},
"in_stock_store_count": 214,
"display_model_store_count": 4,
"rating": 4.0588,
"review_count": 51,
"weighted_rating": 3.5929,
"seller": {
"id": 0,
"name": "JB Hi-Fi"
},
"is_marketplace": false,
"marketplace_offer_count": 0,
"condition": "New",
"product_condition": null,
"release_date": "2025-09-18T14:00:00+00:00",
"published_at": "2025-09-10T00:30:09+00:00"
},
{
"sku": "911474",
"id": "911474",
"is_family": false,
"family_id": null,
"title": "Apple AirPods 5 with Wireless Charging Case",
"subtitle": "Wireless Charging Case",
"url": "https://www.jbhifi.com.au/products/apple-airpods-5-with-wireless-charging-case",
"handle": "apple-airpods-5-with-wireless-charging-case",
"brand": "APPLE",
"model": "MKFT4X/A",
"barcode": "195951378688",
"image": "https://cdn.shopify.com/s/files/1/0024/9803/5810/files/911474-Product-0-I-639245823002978485.jpg?v=1788985565",
"category": "In-ear wireless headphones",
"category_path": [
"Headphones, Speakers & Audio",
"Headphones",
"In-ear headphones"
],
"department": "AUDIO",
"product_group": "HEADPHONES - TRUE WIRELESS",
"price": 240,
"price_ex_gst": 218.18,
"gst": 21.82,
"was_price": null,
"save_amount": null,
"discount_percent": null,
"shows_was_price": false,
"source_was_price": 1,
"source_save_amount": -239,
"ticket_price": 249,
"cashback_amount": 0,
"price_after_cashback": null,
"shows_price_after_cashback": false,
"perks_price": null,
"perks_was_price": null,
"perks_promotions": [],
"currency": "AUD",
"price_record_matches": true,
"on_promotion": false,
"promotion_ends": "2026-12-02T12:59:59+00:00",
"price_badge": "Red Hot Deal",
"badge": null,
"promo_tags": [
"TRADE IN YOUR OLD AIRPODS"
],
"tags": [
"TRADE IN YOUR OLD AIRPODS",
"Red Hot Deal"
],
"delivery_tag": null,
"free_delivery": null,
"button": "Buy",
"availability": {
"status": "InStock",
"statement": "In stock",
"available_now": "Available Now",
"delivery": "InStock",
"click_and_collect": "InStock",
"in_store": "InStock",
"can_buy_online": true,
"can_pre_order": false,
"delivery_only": false,
"online_warehouse_only": false,
"delivery_constraint": "CountryWide",
"fulfilment": "Physical",
"lifecycle": "NonReplenishable",
"displayed": true,
"hidden_by_family": false
},
"in_stock_store_count": 214,
"display_model_store_count": 0,
"rating": 5,
"review_count": 6,
"weighted_rating": 2.8635,
"seller": {
"id": 0,
"name": "JB Hi-Fi"
},
"is_marketplace": false,
"marketplace_offer_count": 0,
"condition": "New",
"product_condition": null,
"release_date": "2026-09-17T14:00:00+00:00",
"published_at": "2026-09-09T20:39:11+00:00"
},
{
"sku": "911473",
"id": "911473",
"is_family": false,
"family_id": null,
"title": "Apple AirPods 5",
"subtitle": null,
"url": "https://www.jbhifi.com.au/products/apple-airpods-5",
"handle": "apple-airpods-5",
"brand": "APPLE",
"model": "MKFW4X/A",
"barcode": "195951379005",
"image": "https://cdn.shopify.com/s/files/1/0024/9803/5810/files/911473-Product-0-I-639245822511379644.jpg?v=1788985505",
"category": "In-ear wireless headphones",
"category_path": [
"Headphones, Speakers & Audio",
"Headphones",
"In-ear headphones"
],
"department": "AUDIO",
"product_group": "HEADPHONES - TRUE WIRELESS",
"price": 200,
"price_ex_gst": 181.82,
"gst": 18.18,
"was_price": null,
"save_amount": null,
"discount_percent": null,
"shows_was_price": false,
"source_was_price": 199,
"source_save_amount": -1,
"ticket_price": 219,
"cashback_amount": 0,
"price_after_cashback": null,
"shows_price_after_cashback": false,
"perks_price": null,
"perks_was_price": null,
"perks_promotions": [],
"currency": "AUD",
"price_record_matches": true,
"on_promotion": false,
"promotion_ends": "2026-12-02T12:59:59+00:00",
"price_badge": "Red Hot Deal",
"badge": null,
"promo_tags": [
"TRADE IN YOUR OLD AIRPODS"
],
"tags": [
"TRADE IN YOUR OLD AIRPODS",
"Red Hot Deal"
],
"delivery_tag": null,
"free_delivery": null,
"button": "Buy",
"availability": {
"status": "InStock",
"statement": "In stock",
"available_now": "Available Now",
"delivery": "InStock",
"click_and_collect": "InStock",
"in_store": "InStock",
"can_buy_online": true,
"can_pre_order": false,
"delivery_only": false,
"online_warehouse_only": false,
"delivery_constraint": "CountryWide",
"fulfilment": "Physical",
"lifecycle": "NonReplenishable",
"displayed": true,
"hidden_by_family": false
},
"in_stock_store_count": 213,
"display_model_store_count": 0,
"rating": 4,
"review_count": 10,
"weighted_rating": 2.8053,
"seller": {
"id": 0,
"name": "JB Hi-Fi"
},
"is_marketplace": false,
"marketplace_offer_count": 0,
"condition": "New",
"product_condition": null,
"release_date": "2026-09-17T14:00:00+00:00",
"published_at": "2026-09-09T20:39:10+00:00"
}
],
"count": 36,
"total": 109,
"total_is_exact": true,
"page": 1,
"page_size": 36,
"total_pages": 4,
"has_more": true,
"reachable_results": 109,
"facets": {
"on_promotion": [
{
"value": "false",
"count": 104
},
{
"value": "true",
"count": 5
}
],
"brand": [
{
"value": "SPIGEN",
"count": 33
},
{
"value": "COMPLY",
"count": 24
},
{
"value": "KATE SPADE",
"count": 10
}
],
"marketplace": [
{
"value": "false",
"count": 66
},
{
"value": "true",
"count": 43
}
],
"seller": [
{
"value": "JB Hi-Fi",
"count": 66
},
{
"value": "PROgadgets",
"count": 33
},
{
"value": "Boutique Retailer",
"count": 2
}
],
"condition": [
{
"value": "New",
"count": 109
}
],
"badge": [
{
"value": "Clearance",
"count": 11
},
{
"value": "On Sale",
"count": 5
}
],
"availability": [
{
"value": "Available Now",
"count": 102
},
{
"value": "Awaiting Stock",
"count": 7
}
],
"department": [
{
"value": "Headphones, Speakers & Audio",
"count": 105
},
{
"value": "Mobile Phones",
"count": 4
}
],
"category": [
{
"value": "Headphones",
"count": 105
},
{
"value": "Phone accessories",
"count": 4
}
],
"subcategory": [
{
"value": "Headphone accessories",
"count": 97
},
{
"value": "Over-ear headphones",
"count": 5
},
{
"value": "Phone chargers",
"count": 4
}
],
"stock_status": [
{
"value": "InStock",
"count": 77
},
{
"value": "LimitedStock",
"count": 25
},
{
"value": "AwaitingStock",
"count": 7
}
],
"tag": [
{
"value": "Online Only",
"count": 43
},
{
"value": "Clearance",
"count": 11
},
{
"value": "TRADE IN YOUR OLD AIRPODS",
"count": 8
}
]
},
"price_range": {
"min": 5,
"max": 799,
"avg": 79.8419
},
"page_beyond_last": false
}
}What the JB Hi-Fi API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | 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. | Pricing teams call search to get keyword search on JB Hi-Fi (jbhifi.com.au or jbhifi.co.nz) with the site's filters. | query, country, category, sort, page, ... |
| suggestions | 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. | Marketplace operators call suggestions to get jB Hi-Fi's own search suggestions (autocomplete) for a partial query, with how often each sug…. | query, country, limit |
| product | 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. | Catalog enrichment teams call product to get one JB Hi-Fi product, everything the site publishes about it. | product, country |
| reviews | 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.) | Retail analysts call reviews to get customer reviews of one JB Hi-Fi product (Bazaarvoice, as shown on the product page). | product, country, sort, rating, page, ... |
| stock | 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. | Pricing teams call stock to get which JB Hi-Fi stores hold stock of a product (and which have it on display), nearest first w…. | product, country, location, radius_km, state, ... |
| deals | 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. | Marketplace operators call deals to get jB Hi-Fi deals. | country, deal_type, query, category, sort, ... |
| categories | 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`. | Catalog enrichment teams call categories to get jB Hi-Fi's category menu as the site shows it (Products → Computers & Tablets → Laptops …, pl…. | country |
| category | 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`. | Retail analysts call category to get the products of one JB Hi-Fi category (collection) page, e.g. | category, country, query, sort, page, ... |
| brands | 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. | Pricing teams call brands to get every brand JB Hi-Fi lists, with how many products each has, optionally inside one category o…. | country, category, query, sort, page, ... |
| stores | 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. | Marketplace operators call stores to get jB Hi-Fi stores (and JB Hi-Fi HOME stores). | country, query, location, radius_km, state, ... |
| store | One JB Hi-Fi store: address, phone, coordinates, opening hours, this week's and special trading hours, services and ranged categories. | Catalog enrichment teams call store to get one JB Hi-Fi store. | store, country |
| sitemap | 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. | Retail analysts call sitemap to get the site's own sitemap index. | country, type |
| sitemap_products | 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. | Pricing teams call sitemap_products to get one product sitemap file of JB Hi-Fi (about 1 000 product links each, with last-modified date…. | country, page |
Call search from your stack
curl -X POST https://api.reefapi.com/jbhifi/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"airpods"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/jbhifi/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "airpods"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/jbhifi/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "airpods"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.jbhifi.search with {"query":"airpods"}.Who uses this API and why
- Track JB Hi-Fi prices and printed discounts across Australia and New Zealand.
- Check which JB Hi-Fi stores near a postcode hold a product.
- Match JB Hi-Fi products to other retailers by barcode and model number.
- Monitor Clearance, Red Hot Deal and Black Friday items by category.
- Collect customer ratings, star counts and review texts per SKU.
Questions developers ask before integrating
Does it cover JB Hi-Fi New Zealand?
Yes. Pass country=nz for jbhifi.co.nz (NZD), or paste a jbhifi.co.nz link. Search, products, stock, reviews, stores, categories and deals all work there; the title A-Z sort is not offered on the New Zealand site because it does not sort by title.
Which filters does search have?
Brand, seller, condition, price range, in stock, on sale, availability, marketplace, tag, category and any spec filter, each checked against the unfiltered count in the same run: "headphones" 1,263 results became 78 for Sony, 321 between $100 and $300, 147 on sale, 461 from marketplace sellers and 44 tagged Clearance.
Can I see which stores have a product in stock?
stock returns every listed store with in_stock and display_model, nearest first from a postcode, suburb or coordinates. On 2026-11-16 AirPods Pro 3 were in 210 of 210 Australian stores and the iPhone 17 256GB Black in 191.
How many results can I page through?
Up to 100 rows per page and the first 12,000 results of any listing. Three consecutive pages of 36 rows came back with no repeated product.
Are marketplace sellers included?
Yes. Rows say whether JB Hi-Fi or a marketplace seller sells the item, and product lists each marketplace seller's offer with its price and shipping range. marketplace=exclude or only narrows a listing.
Do I get the barcode?
Yes, the EAN on 20 of 22 sampled products; the 2 without one were marketplace items.
What deals can I list?
Items on promotion (7,794 in Australia on 2026-11-16), Clearance (3,303), Red Hot Deal (997), Black Friday (871), JB Exclusive, Pre-Order, New at JB!, Refurbished, Bonus Offer, Bundle Buy, Online Only and In Store Only, with the same filters as search.
Is anything missing?
Delivery prices and dates for a postcode are not returned. Customer reviews carry no photos on JB Hi-Fi (none in an 8-product sample), and the site keeps no price history.
What is the JB Hi-Fi API?
JB Hi-Fi API is a ReefAPI endpoint group for jb hi-fi australia and new zealand: prices with the printed was-price, stock in every store, specs, barcodes, reviews and deals. It returns live JSON through POST requests under /jbhifi/v1.
Is the JB Hi-Fi API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. JB Hi-Fi calls use the same shared credit balance as every other ReefAPI engine.
Do I need a JB Hi-Fi login or account?
No login to JB Hi-Fi 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 JB Hi-Fi 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 JB Hi-Fi API use?
JB Hi-Fi actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call JB Hi-Fi from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call jbhifi actions with the same key, credit pool and JSON envelope used by normal REST requests.