# Bunnings Scraper - Products, Reviews & Q\&A (`abotapi/bunnings-com-au-scraper`) Actor Scrape bunnings.com.au products with full specifications, price, brand, stock, image gallery, warranty, customer reviews, rating stats and Q\&A. Search by keyword with brand, price, rating and sort filters, or paste product / category / search URLs. - **URL**: https://apify.com/abotapi/bunnings-com-au-scraper.md - **Developed by:** [Abot API](https://apify.com/abotapi) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 product results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Bunnings Scraper - Products & Reviews from bunnings.com.au Extract structured product data from Bunnings Warehouse (bunnings.com.au), Australia's largest hardware and home-improvement retailer. Search by keyword with brand, price, rating and sort filters, or paste product, category and search URLs - and get clean JSON with full specifications, pricing, image galleries, warranty, and **customer reviews with rating statistics**. Running on the Apify platform gives you API access, scheduling, integrations (Google Sheets, Zapier, webhooks), automatic proxy rotation and full run monitoring out of the box. ### What it does Give it a keyword (or a list of Bunnings URLs) and it returns one structured record per product. Category and search results are collected across multiple pages, so you can gather hundreds of drills, mowers, paints or fasteners in a single run. #### Fields per product | Field | Description | |-------|-------------| | `code`, `itemNumber` | Bunnings product code / item number | | `name` | Product name | | `brand`, `brandCode`, `brandUrl` | Brand name, code and brand page | | `isLeadingBrand`, `isTradeBrand` | Brand flags | | `price`, `currency`, `formattedPrice` | Price, currency and formatted price | | `priceType`, `priceAvailable` | Price type (e.g. FROM) and availability flag | | `paymentOptions` | Instalment options (Afterpay, PayPal, Zip) | | `unitOfPrice` | Unit-of-measure price where shown | | `rating`, `ratingCount` | Average star rating and number of ratings | | `reviewStats` | Aggregate rating stats + star distribution | | `reviews[]` | Review text, star rating, author, date, recommended flag, helpful votes | | `specifications` | Flattened spec name to value map | | `features[]` | Full feature list (name, code, value) | | `summary` | Product summary | | `warranty` | Warranty & returns text | | `weight`, `dimension` | Weight and packaged / product dimensions | | `images[]`, `imageUrl`, `thumbnailUrl` | Full image gallery and primary image | | `categories`, `superCategories`, `categoryPath` | Category taxonomy | | `keySellingPoints` | Key selling points | | `availableForDelivery`, `inStorePickup`, `purchasable` | Availability flags | | `fulfilment` | Delivery / click-and-collect fulfilment detail | | `isTradeOnly`, `isSpecialProduct`, `isDangerousGood`, `customMade` | Product flags | | `bestSeller`, `newArrival`, `forHire`, `ageRestricted` | Merchandising flags | | `variantCount`, `size`, `productRanges` | Variant and range info | | `url`, `source`, `searchMode` | Canonical URL and provenance | ### Input Configure the run in the **Input** tab. #### Search mode ```json { "mode": "search", "queries": ["cordless drill", "exterior paint"], "brand": "Ryobi", "sortBy": "ratingDesc", "minPrice": 20, "maxPrice": 500, "minRating": 4, "fetchDetails": true, "fetchReviews": true, "maxItems": 50 } ```` #### URL mode ```json { "mode": "url", "urls": [ "https://www.bunnings.com.au/our-range/tools/power-tools/drills", "https://www.bunnings.com.au/search/products?q=hammer", "https://www.bunnings.com.au/ryobi-18v-one-drill-driver-starter-kit-r18dd22_p0715241" ], "fetchDetails": true, "fetchReviews": true } ``` #### Options - **mode** - `search` (keyword + filters) or `url` (paste links). Product URLs (ending in `_p`) return a single product; category and search URLs return multiple pages of results. - **queries** - one or more search keywords (search mode). - **brand** - keep only products whose brand contains this text. - **sortBy** - `relevance`, `priceAsc`, `priceDesc`, `ratingDesc`, `reviewsDesc`, `nameAsc`. - **minPrice / maxPrice / minRating** - result filters. - **fetchDetails** - open each product page for full specifications, warranty, dimensions, gallery and price breakdown (default on). - **fetchReviews** - collect customer reviews + rating statistics. - **maxReviewsPerProduct** - cap reviews per product (0 = all). - **maxItems / maxPages** - run-size caps. - **proxy** - Apify Proxy with residential access in Australia is recommended for reliable results. ### Pricing You are billed for the results you actually collect: a small charge per product returned, plus optional charges only when detail extraction or reviews are enabled. See the actor's Pricing tab for current rates. ### Send results into your apps (MCP connectors) Optionally pipe results into the apps you already use via Model Context Protocol (MCP) connectors - Notion, Linear, Airtable or Apify. Authorize a connector under Apify, Settings, API & Integrations, then select it in the input. This never changes the dataset output. ### Notes - Review availability varies per product; products with no reviews return an empty array. - **Plan Requirement:** runs on any Apify plan. On the free plan, proxy coverage may be limited and some runs may return fewer results. # Actor input Schema ## `mode` (type: `string`): Choose 'search' to use keywords and filters, or 'url' to scrape specific product, category or search URLs you paste below. ## `queries` (type: `array`): One or more keywords to search, for example 'cordless drill' or 'exterior paint'. Each keyword is searched separately. ## `brand` (type: `string`): Optional. Keep only products whose brand contains this text, for example 'Ryobi', 'Makita' or 'Ozito'. ## `sortBy` (type: `string`): Ordering applied to the collected results. ## `minPrice` (type: `integer`): Optional. Only keep products priced at or above this amount (AUD). ## `maxPrice` (type: `integer`): Optional. Only keep products priced at or below this amount (AUD). ## `minRating` (type: `integer`): Optional. Only keep products with an average customer rating at or above this value (1 to 5). ## `urls` (type: `array`): Product, category or search URLs to scrape, for example https://www.bunnings.com.au/our-range/tools/power-tools/drills or https://www.bunnings.com.au/search/products?q=hammer. Multiple URLs supported. ## `fetchDetails` (type: `boolean`): Open each product page for full specifications, warranty, dimensions, image gallery, brand detail and price breakdown. Adds one request per product. ## `fetchReviews` (type: `boolean`): Also collect customer reviews for each product (review text, star rating, author, date) plus aggregate rating statistics. Adds requests per product. ## `maxReviewsPerProduct` (type: `integer`): Cap on reviews collected per product when 'Fetch customer reviews' is on. Use 0 for all available reviews. ## `maxItems` (type: `integer`): Maximum number of products to return across the whole run. Use 0 for unlimited. ## `maxPages` (type: `integer`): Safety cap on result pages walked per keyword / URL. Leave high; the run stops automatically once Max products is reached. ## `proxy` (type: `object`): Apify Proxy with residential access in Australia is recommended for reliable results. On the free plan, coverage may be limited and some runs may return no results. ## `mcpConnectors` (type: `array`): Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a rich page-per-item export; other connectors get a best-effort write/digest. Leave empty to skip; never changes the dataset output. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com). ## `notionParentPageUrl` (type: `string`): URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors. ## `maxNotifyListings` (type: `integer`): Cap on items written to each connector per run. Does not affect the dataset. ## Actor input object example ```json { "mode": "search", "queries": [ "cordless drill" ], "sortBy": "relevance", "urls": [ "https://www.bunnings.com.au/search/products?q=hammer" ], "fetchDetails": true, "fetchReviews": false, "maxReviewsPerProduct": 20, "maxItems": 20, "maxPages": 100, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" }, "maxNotifyListings": 50 } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "cordless drill" ], "urls": [ "https://www.bunnings.com.au/search/products?q=hammer" ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/bunnings-com-au-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": ["cordless drill"], "urls": ["https://www.bunnings.com.au/search/products?q=hammer"], "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AU", }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/bunnings-com-au-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "queries": [ "cordless drill" ], "urls": [ "https://www.bunnings.com.au/search/products?q=hammer" ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" } }' | apify call abotapi/bunnings-com-au-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/bunnings-com-au-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bunnings Scraper - Products, Reviews & Q&A", "description": "Scrape bunnings.com.au products with full specifications, price, brand, stock, image gallery, warranty, customer reviews, rating stats and Q&A. Search by keyword with brand, price, rating and sort filters, or paste product / category / search URLs.", "version": "1.0", "x-build-id": "Zd8DiATRoEJx4cboc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~bunnings-com-au-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-bunnings-com-au-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/abotapi~bunnings-com-au-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-bunnings-com-au-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/abotapi~bunnings-com-au-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-bunnings-com-au-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "Choose 'search' to use keywords and filters, or 'url' to scrape specific product, category or search URLs you paste below.", "default": "search" }, "queries": { "title": "Search keywords", "type": "array", "description": "One or more keywords to search, for example 'cordless drill' or 'exterior paint'. Each keyword is searched separately.", "items": { "type": "string" } }, "brand": { "title": "Brand", "type": "string", "description": "Optional. Keep only products whose brand contains this text, for example 'Ryobi', 'Makita' or 'Ozito'." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "priceAsc", "priceDesc", "ratingDesc", "reviewsDesc", "nameAsc" ], "type": "string", "description": "Ordering applied to the collected results.", "default": "relevance" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Optional. Only keep products priced at or above this amount (AUD)." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Optional. Only keep products priced at or below this amount (AUD)." }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Optional. Only keep products with an average customer rating at or above this value (1 to 5)." }, "urls": { "title": "Bunnings URLs", "type": "array", "description": "Product, category or search URLs to scrape, for example https://www.bunnings.com.au/our-range/tools/power-tools/drills or https://www.bunnings.com.au/search/products?q=hammer. Multiple URLs supported.", "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch product details", "type": "boolean", "description": "Open each product page for full specifications, warranty, dimensions, image gallery, brand detail and price breakdown. Adds one request per product.", "default": true }, "fetchReviews": { "title": "Fetch customer reviews", "type": "boolean", "description": "Also collect customer reviews for each product (review text, star rating, author, date) plus aggregate rating statistics. Adds requests per product.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 0, "type": "integer", "description": "Cap on reviews collected per product when 'Fetch customer reviews' is on. Use 0 for all available reviews.", "default": 20 }, "maxItems": { "title": "Max products", "minimum": 0, "type": "integer", "description": "Maximum number of products to return across the whole run. Use 0 for unlimited.", "default": 20 }, "maxPages": { "title": "Max pages per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Safety cap on result pages walked per keyword / URL. Leave high; the run stops automatically once Max products is reached.", "default": 100 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy with residential access in Australia is recommended for reliable results. On the free plan, coverage may be limited and some runs may return no results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a rich page-per-item export; other connectors get a best-effort write/digest. Leave empty to skip; never changes the dataset output. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```