# Screwfix Trade & Industrial Supply Catalog Scraper (`crawlerbros/screwfix-trade-supply-catalog-scraper`) Actor Scrape Screwfix.com - the UK's largest trade tool, hardware, and industrial/MRO supply catalog. Search by keyword, browse a curated category, or fetch full product detail (price, brand, images, reviews) by item number. - **URL**: https://apify.com/crawlerbros/screwfix-trade-supply-catalog-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## Screwfix Trade & Industrial Supply Catalog Scraper Scrape **Screwfix.com** — the UK's largest trade tool, hardware, and industrial/MRO (maintenance, repair & operations) supply catalog with hundreds of thousands of products across tools, fixings, electrical, plumbing, safety workwear, and more. Search by keyword, browse a curated category, or fetch full product detail (price, brand, images, ratings) by item number. Prices are public — no trade account or login required. ### What this actor does - **Three modes:** `search`, `category`, `byItemNumber` - **16 curated leaf categories** across Tools, Fixings, Electrical, Plumbing, Safety, and more, plus a free-text category URL override - **Price, rating, and brand filters:** `minPrice` / `maxPrice` / `minRating` / `brand` - **Rich product detail:** brand, full description, technical specification table, image gallery, video, star rating, review count - **Merchandising signals on every listing:** was-price/savings, promo badges (e.g. "Great Value Product"), delivery/collection availability — sourced from Screwfix's own page data, not just the JSON-LD summary - **Empty fields are omitted** ### Output per product - `title`, `brand` - `itemNumber` — Screwfix's own SKU (e.g. `13266`) - `price`, `currency` (GBP), `wasPrice`, `savingsAmount`, `savingsPercent` — when the item is on promotion - `availability` — `InStock` / `OutOfStock` (detail lookups only); `availableForDelivery`, `availableForCollection`, `stockedInTradeCounter` (search/category/detail) - `badgeText` — Screwfix's own promo badge label (e.g. "Great Value Product"), when shown - `description` (detail lookups only), `fullDescription` (detail lookups only, when materially longer than `description`) - `bulletPoints[]` — key feature bullets (search/category/detail, when available) - `technicalSpecifications[]` — `{name, value}` spec table (detail lookups only) - `imageUrl`, `imageUrls[]` (full gallery on detail lookups only), `videoUrl`, `brandLogoUrl` (detail lookups only) - `ratingValue`, `reviewCount` - `category`, `categoryPath[]` — breadcrumb trail - `sourceUrl`, `recordType: "screwfixProduct"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `search` | `search` / `category` / `byItemNumber` | | `searchQuery` | string | `drill bit` | Free-text keyword search (mode=search) | | `categorySlug` | string | `tools/drilling/cat5920002` | One of 16 curated leaf categories (mode=category) | | `categoryUrl` | string | – | Custom category URL, overrides `categorySlug` (mode=category) | | `brand` | string | – | Restrict to a single brand, e.g. `DEWALT` | | `itemNumbers` | array | – | Screwfix item numbers or full product URLs (mode=byItemNumber) | | `minPrice` | int | – | Drop products priced below this amount | | `maxPrice` | int | – | Drop products priced above this amount | | `minRating` | int (1-5) | – | Only return products rated this many stars or higher (mode=search/category), applied server-side | | `maxItems` | int | `30` | Hard cap (1–1000) | #### Example: search with a brand and price ceiling ```json { "mode": "search", "searchQuery": "impact driver", "brand": "DEWALT", "maxPrice": 150, "maxItems": 50 } ```` #### Example: browse a category ```json { "mode": "category", "categorySlug": "screws-nails-fixings/concrete-screws/cat840054", "maxItems": 100 } ``` #### Example: lookup specific products ```json { "mode": "byItemNumber", "itemNumbers": ["13266", "https://www.screwfix.com/p/erbauer-drill-bits/65352"] } ``` ### Use cases - **Price monitoring** — track trade tool and hardware prices over time - **Procurement research** — compare brands and prices across MRO categories - **Catalog enrichment** — pull structured product data (images, ratings) for internal systems - **Market research** — analyze category breadth, brand coverage, and customer ratings - **Competitive intelligence** — benchmark trade-supply pricing against other retailers ### FAQ **Do I need a trade account to see prices?** No — Screwfix shows prices to anonymous visitors; this actor never uses cookies or a login. **Is this the same as Screwfix's consumer DIY range?** Screwfix serves both tradespeople and DIY customers from the same catalog — tools, fixings, electrical, plumbing, and safety workwear are all genuine trade/industrial supply categories alongside general hardware. **Why do search/category listings have fewer fields than `byItemNumber` lookups?** Listing pages show enough to browse (title, brand, price, rating, image); the full description and image gallery require opening the individual product page, which `mode=byItemNumber` does explicitly. **What currency are prices in?** GBP (£) — Screwfix is a UK retailer. **Why might a category return 0 results?** The curated `categorySlug` list only includes verified leaf categories that list products directly. A custom `categoryUrl` pointing at a category *hub* page (one that only links to further subcategories) will return 0 products — pick the specific subcategory instead. **How does the `brand` filter work on search/category listings?** Screwfix's listing pages don't publish a dedicated brand field per product, so the filter matches the brand name as a substring of the title (which conventionally leads with the brand). `mode=byItemNumber` lookups return a dedicated `brand` field from the product page and use an exact match instead. **Why did my search return results that don't look related to my query?** For queries with no real matches, Screwfix's own search occasionally falls back to a generic/trending result set rather than an empty page — the actor faithfully returns whatever the site's search returns. **Is this affiliated with Screwfix?** No — this is an independent third-party actor reading Screwfix's public catalog pages. **How fresh is the data?** Prices and stock status reflect what Screwfix's website shows at scrape time and can change frequently. ### Limitations **Sort order isn't exposed.** Screwfix's search UI offers a sort dropdown (relevance, price, brand A-Z/Z-A, rating), but it's driven by client-side JavaScript against a session-scoped backend call — plain query-string parameters (`sort=`, `sortBy=`, etc.) were tested directly against the site and reliably zero out the result set rather than reordering it. Rather than ship an unverified, possibly-broken parameter, this actor omits sort order. Results are returned in Screwfix's default relevance order; use `minPrice`/`maxPrice`/`minRating`/`brand` to narrow results instead. **Category-specific attribute filters aren't exposed.** Screwfix's search results also expose highly dynamic per-query facets (e.g. "Drill Bit Type", "Shank Type", "Tip Material" for a drill-bit search) that change entirely based on the search term — these aren't a stable, enumerable input surface across all product categories, so they're intentionally left out in favor of the universal `minPrice`/`maxPrice`/`minRating`/`brand` filters. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `searchQuery` (type: `string`): Free-text keyword search, e.g. `drill bit`, `safety boots`, `radiator`. ## `categorySlug` (type: `string`): Pick one of Screwfix's leaf shopping categories. Leave as "Custom category URL" and fill `categoryUrl` to browse any other category. ## `categoryUrl` (type: `string`): Full screwfix.com category URL (e.g. `https://www.screwfix.com/c/tools/drilling/cat5920002`). Overrides `categorySlug` when set. ## `brand` (type: `string`): Restrict results to a single brand name, e.g. `DEWALT`, `Bosch`, `Makita` (mode=search/category). Exact match against the product brand where available, otherwise a case-insensitive substring match against the title. ## `itemNumbers` (type: `array`): Screwfix item numbers (e.g. `13266`) or full product URLs. ## `minPrice` (type: `integer`): Drop products priced below this amount (mode=search/category). ## `maxPrice` (type: `integer`): Drop products priced above this amount (mode=search/category). ## `minRating` (type: `integer`): Only return products rated this many stars or higher, e.g. `4` keeps 4.0-5.0-star products (mode=search/category). Applied server-side via Screwfix's own star-rating facet. Apify schema does not support `select`/`enum` on integer fields, so this is a plain bounded number input. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## Actor input object example ```json { "mode": "search", "searchQuery": "drill bit", "categorySlug": "tools/drilling/cat5920002", "itemNumbers": [], "maxItems": 30 } ``` # Actor output Schema ## `products` (type: `string`): Dataset containing all scraped Screwfix products. # 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 = { "mode": "search", "searchQuery": "drill bit", "categorySlug": "tools/drilling/cat5920002", "itemNumbers": [], "maxItems": 30 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/screwfix-trade-supply-catalog-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 = { "mode": "search", "searchQuery": "drill bit", "categorySlug": "tools/drilling/cat5920002", "itemNumbers": [], "maxItems": 30, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/screwfix-trade-supply-catalog-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 '{ "mode": "search", "searchQuery": "drill bit", "categorySlug": "tools/drilling/cat5920002", "itemNumbers": [], "maxItems": 30 }' | apify call crawlerbros/screwfix-trade-supply-catalog-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/screwfix-trade-supply-catalog-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Screwfix Trade & Industrial Supply Catalog Scraper", "description": "Scrape Screwfix.com - the UK's largest trade tool, hardware, and industrial/MRO supply catalog. Search by keyword, browse a curated category, or fetch full product detail (price, brand, images, reviews) by item number.", "version": "1.0", "x-build-id": "pFnwMnErbd4yqyeid" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~screwfix-trade-supply-catalog-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-screwfix-trade-supply-catalog-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/crawlerbros~screwfix-trade-supply-catalog-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-screwfix-trade-supply-catalog-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/crawlerbros~screwfix-trade-supply-catalog-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-screwfix-trade-supply-catalog-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", "category", "byItemNumber" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Free-text keyword search, e.g. `drill bit`, `safety boots`, `radiator`.", "default": "drill bit" }, "categorySlug": { "title": "Category (mode=category)", "enum": [ "", "tools/drilling/cat5920002", "tools/hammers-axes/cat9790001", "tools/screwdrivers-hex-keys/cat831030", "tools/sockets-spanners-wrenches/cat3470004", "screws-nails-fixings/concrete-screws/cat840054", "electrical-lighting/commercial-lighting/cat840784", "heating-plumbing/aluminium-radiators/cat7640003", "safety-workwear/chainsaw-boots/cat8520026", "storage-ladders/step-ladders/cat831476", "sealants-adhesives/carpet-tape/cat16240004", "security-ironmongery/cabinet-hinges/cat840984", "painting-decorating/lining-paper/cat6100030", "outdoor-gardening/garden-hoses/cat840692", "building-doors/skirting-board/cat9460002", "bathrooms-kitchens/bathroom-taps/cat7310006", "auto-cleaning/bodywork-tools/cat810040" ], "type": "string", "description": "Pick one of Screwfix's leaf shopping categories. Leave as \"Custom category URL\" and fill `categoryUrl` to browse any other category.", "default": "tools/drilling/cat5920002" }, "categoryUrl": { "title": "Custom category URL (mode=category)", "type": "string", "description": "Full screwfix.com category URL (e.g. `https://www.screwfix.com/c/tools/drilling/cat5920002`). Overrides `categorySlug` when set." }, "brand": { "title": "Brand filter", "type": "string", "description": "Restrict results to a single brand name, e.g. `DEWALT`, `Bosch`, `Makita` (mode=search/category). Exact match against the product brand where available, otherwise a case-insensitive substring match against the title." }, "itemNumbers": { "title": "Item numbers (mode=byItemNumber)", "type": "array", "description": "Screwfix item numbers (e.g. `13266`) or full product URLs.", "default": [], "items": { "type": "string" } }, "minPrice": { "title": "Min price (GBP)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Drop products priced below this amount (mode=search/category)." }, "maxPrice": { "title": "Max price (GBP)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Drop products priced above this amount (mode=search/category)." }, "minRating": { "title": "Minimum star rating (1-5)", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only return products rated this many stars or higher, e.g. `4` keeps 4.0-5.0-star products (mode=search/category). Applied server-side via Screwfix's own star-rating facet. Apify schema does not support `select`/`enum` on integer fields, so this is a plain bounded number input." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 30 } } }, "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 } } } } } } } } } } ```