thegoodguys.com.au APIthegoodguys.com.au ↗
Access The Good Guys catalog via API: search products, browse categories, get specs, reviews, deals, store locations, and delivery options for Australian electronics.
curl -X GET 'https://api.parse.bot/scraper/4aa26cf9-b977-40a1-a782-75f045da8ed7/search_products?page=0&limit=3&query=tv' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword. Returns paginated results from the product catalog.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-based) |
| limit | integer | Results per page |
| queryrequired | string | Search keyword (e.g. 'samsung tv', 'laptop', 'washing machine') |
{
"type": "object",
"fields": {
"pages": "integer total number of pages",
"total": "integer total number of matching products",
"products": "array of product objects with title, price, sku, handle, vendor, image, categories, meta",
"current_page": "integer current page number (0-based)"
},
"sample": {
"data": {
"pages": 238,
"total": 714,
"products": [
{
"sku": "50094577",
"image": "https://cdn.shopify.com/s/files/1/0641/9388/8321/files/50094577_957162.png?v=1776565366",
"price": 449,
"title": "FFALCON 50\" U65 LED Google TV 2025",
"handle": "ffalcon-50-inches-u65-led-google-tv-2025-ff50u65",
"vendor": "FFALCON"
}
],
"current_page": 0
},
"status": "success"
}
}About the thegoodguys.com.au API
The Good Guys API covers 10 endpoints against The Good Guys' Australian electronics and appliances catalog, giving programmatic access to product search, full specs, customer reviews, brand listings, category trees, current deals, store locations, and per-postcode delivery options. The get_product_detail endpoint alone returns over a dozen fields including structured technical specs, pricing, hierarchical categories, and a sample of up to 10 customer reviews per product.
Product Discovery and Catalog
Use search_products to query the full catalog by keyword — results return paginated arrays of product objects with title, price, sku, handle, vendor, image, and a nested categories object. get_category_listing narrows results to a specific category using a category_handle value (e.g. televisions, laundry), which you obtain from get_category_tree. The category tree returns the full two-level hierarchy with product counts at each node, making it straightforward to build dynamic navigation or inventory dashboards. get_brand_products works the same way but filters by brand name exactly as it appears in the get_brands response.
Product Detail, Specs, and Reviews
get_product_detail accepts either a handle slug or a full product url and returns the complete product record: meta (containing technical specs, promotions, key features, and dimensions), body_html_safe description text, image, price, vendor, hierarchical categories (lvl0–lvl3), and a reviews_sample array of up to 10 recent reviews. For deeper review coverage, get_product_reviews accepts a sku and supports pagination via page and limit params; each review object includes rating, review_title, review_text, your_name, submission_date, and is_recommended.
Deals, Stores, and Delivery
get_deals returns paginated clearance and sale products with the same product object shape used across the catalog. get_store_locator takes a 4-digit Australian postcode and returns an array of nearby stores with name, address, storePhoneNumber, hours, distance in kilometres, and latitude/longitude. get_delivery_options takes a sku plus a postcode and returns both a fulfilmentExperienceFE array of delivery options and a checkStockResponse showing per-store stock status including inStore, clickCollect, and distance fields for each nearby location.
- Track price changes on specific SKUs across categories for competitive appliance pricing analysis.
- Build a category-browsing product feed using
get_category_treeandget_category_listingfor an affiliate or comparison site. - Aggregate customer review sentiment using
get_product_reviewswith pagination across a brand's full product range. - Surface current clearance items via
get_dealsfor a deals-alert or cashback application. - Check real-time store stock and click-and-collect availability using
get_delivery_optionsfor a given postcode. - Enrich a product database with structured technical specs and dimensions from the
metafield inget_product_detail. - Power a store-finder feature using
get_store_locatorwith coordinates and opening hours per location.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does The Good Guys offer an official public developer API?+
What does `get_product_detail` return beyond basic pricing?+
meta object with technical specifications, key features, dimensions, and promotions; body_html_safe product description text; hierarchical categories (lvl0 through lvl3); and a reviews_sample array of up to 10 customer reviews. The handle and sku fields can be used as inputs to other endpoints like get_product_reviews and get_delivery_options.Does `get_delivery_options` return estimated delivery dates or shipping costs?+
fulfilmentExperienceFE array of delivery/fulfilment option objects and a checkStockResponse showing per-store stock status with inStore and clickCollect flags. Specific estimated delivery dates and itemised shipping costs are not currently included in the response fields. You can fork this API on Parse and revise it to add an endpoint targeting that data if it becomes available.How does pagination work across search and category endpoints?+
search_products, get_category_listing, get_brand_products, get_deals, and get_product_reviews — use a 0-based page parameter alongside a limit parameter. Responses include a total count of matching records and a pages count of available pages, so you can iterate through the full result set programmatically.Is historical pricing or price history data available?+
price field at the time of the request but does not expose historical pricing data or price change logs. You can fork the API on Parse and revise it to record and expose price snapshots over time.