JB Hi-Fi Electronics Scraper

Scrape JB Hi-Fi's Australian electronics catalog — search by keyword, browse by department or brand, and filter by price and stock status. Uses JB Hi-Fi's public storefront JSON API. No login, no cookies, no paid proxy required.

What this actor does

• Four modes: search, byCategory, byBrand, byUrl (direct product URL/handle lookup)
• 19 department categories: computers & laptops, TVs & home theatre, audio, cameras, mobile phones, gaming, small appliances, whitegoods, home tech, wearables, accessories, movies, music, and more
• 300+ brands: curated dropdown of top brands (Apple, Samsung, Sony, Google, HP, Asus...) plus free-text override for any other brand
• Filters: price range, stock availability (in stock / limited stock / awaiting stock / out of stock)
• Empty fields are omitted

Output per product

• productId — JB Hi-Fi/Shopify product ID
• title
• brand — manufacturer/vendor
• category — department (see enum list below)
• price, currency (AUD)
• compareAtPrice, discountPercent — when the item is on sale
• availability — In Stock / Limited Stock / Awaiting Stock / Out of Stock
• sku
• imageUrl
• description — plain-text, HTML stripped, truncated to ~700 characters
• productUrl
• recordType: "product", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / byCategory / byBrand / byUrl
searchQuery	string	headphones	Keyword matched against title + brand (mode=search)
category	select	–	Department (mode=byCategory; also usable as a filter in other modes)
brand	select	–	Curated top brand (mode=byBrand; exact match)
brandQuery	string	–	Free-text brand substring — overrides brand when set
productUrls	array of strings	–	Exact product URL(s) or handle(s) to fetch directly (mode=byUrl)
minPrice / maxPrice	number	–	Price range in AUD
availability	select	–	Stock-status filter
maxItems	int	20	Hard cap (1–2000)
proxyConfiguration	object	AUTO	Optional; only engaged automatically if JB Hi-Fi rate-limits/blocks the request

Example: search

{ "mode": "search", "searchQuery": "iphone", "maxItems": 20 }

Example: browse a category with filters

{
  "mode": "byCategory",
  "category": "COMPUTERS",
  "minPrice": 500,
  "maxPrice": 2000,
  "availability": "inStock",
  "maxItems": 50
}

Example: browse a brand not in the curated dropdown

{ "mode": "byBrand", "brandQuery": "razer", "maxItems": 30 }

Example: fetch specific products directly by URL

{
  "mode": "byUrl",
  "productUrls": [
    "https://www.jbhifi.com.au/products/marshall-mode-usb-c-in-ear-headphones-black",
    "https://www.jbhifi.com.au/products/jbl-tune-770-wireless-adaptive-noise-cancelling-over-ear-headphones-black"
  ]
}

Use cases

• Price monitoring — track JB Hi-Fi pricing across categories or specific brands
• Market research — analyze Australian consumer electronics assortment and stock levels
• Deal discovery — filter by price range and stock status to surface bargains
• Competitive intelligence — compare catalog breadth against other Australian electronics retailers
• Product data enrichment — bulk-fetch structured product data (SKU, images, pricing) for a category

FAQ

Does this require login or cookies? No. JB Hi-Fi's public product catalog is fully accessible without authentication.

Why isn't there a rating field? JB Hi-Fi's storefront does not expose a populated customer-rating widget in its public product data (checked across multiple bestsellers, including iPhones) — the review-app metafields are present in the page template but unpopulated. We only ship fields we can reliably populate with real data.

How is availability determined? From JB Hi-Fi's own stock tags (InStock, LimitedStock, AwaitingStock) with a fallback to the variant-level available flag when no tag is present. In practice availability=outOfStock rarely matches anything — JB Hi-Fi's public storefront feed only lists products that are still purchasable, so fully sold-out items are typically unpublished from the catalog rather than shown with a "sold out" tag.

Can I search for a brand that isn't in the dropdown? Yes — use brandQuery for a free-text substring match. JB Hi-Fi stocks 300+ brands; the dropdown only curates the highest-volume ones.

Can I fetch a specific product directly, without searching? Yes — set mode to byUrl and pass one or more exact product page URLs (or bare handles/slugs) in productUrls. Each is fetched directly; invalid/unpublished handles are skipped without failing the rest of the run.

What currency are prices in? Australian dollars (AUD) — JB Hi-Fi is an Australian retailer.

How fresh is the data? Real-time — every run queries JB Hi-Fi's live storefront API directly.