# Ferguson Home Product Scraper (`axlymxp/ferguson-product-scraper`) Actor Scrape Ferguson Home (Build.com) products at scale — prices, SKUs, finishes, stock status, MSRP, ratings, specs and images. Search by keyword or category ID and export clean structured data for pricing intelligence, catalog sync and market research. Pay only for results. - **URL**: https://apify.com/axlymxp/ferguson-product-scraper.md - **Developed by:** [axly](https://apify.com/axlymxp) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 33.3% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 dataset items This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 ## Ferguson Home Product Scraper Export the **Ferguson Home** (formerly **Build.com**) catalog as clean, structured data. Search by keyword or list an entire category and get **prices, SKUs, every finish variant, live stock status, MSRP, ratings, specifications and images** — no proxies, logins or browser automation required. Ferguson Home is one of the largest US retailers for plumbing, lighting, appliances, bath, kitchen and hardware. This actor reads the same private JSON API the official mobile app uses, so results are fast, complete and reliable. ### Who it's for - **Pricing & market analysts** — track prices and MSRP across brands and finishes. - **E‑commerce & marketplace sellers** — build competitive pricing and assortment data. - **PropTech / renovation SaaS** — enrich product catalogs with specs, images and stock. - **Manufacturers & brands** — monitor how your products are listed, priced and rated. - **Researchers & data teams** — bulk‑export a large home‑improvement catalog to JSON/CSV/Excel. ### What you get (output fields) | Field | Type | Description | | ----------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------- | | `compositeId` | integer | Stable Ferguson product family ID | | `model` | string | Manufacturer model number (e.g. `19867LF`) | | `brand` | string | Manufacturer / brand (e.g. `Delta`) | | `title` | string | Product title | | `series` | string | Series / collection name | | `type` | string | Product type (e.g. `Faucet`) | | `productUrl` | string | Canonical fergusonhome.com product URL | | `minPrice` / `maxPrice` | number | Lowest / highest current price across finishes (USD) | | `minMsrp` / `maxMsrp` | number | Lowest / highest MSRP across finishes (USD) | | `currency` | string | Always `USD` | | `avgRating` | number | Average review rating (0–5) | | `reviewCount` | integer | Number of reviews | | `bvProductId` | string | Bazaarvoice product id behind the ratings | | `isConfigurable` | boolean | Configurable / build‑to‑order item | | `isDiscontinued` | boolean | Discontinued flag | | `freeShipping` | boolean | Ships free | | `finishCount` | integer | Number of finish/SKU variants | | `finishes` | array | Per‑finish variants: `uniqueId`, `name`, `sku`, `price`, `msrp`, `status`, `inStock`, `inventory`, `image`, `swatchHex` | | `images` | array | Product image URLs | | `specs` | array | Specifications as `{name, value, units}` | | `categoryId` | integer | Category listed under (category mode) | | `description` | string | Plain‑text description *(when `includeDetail`)* | | `breadcrumbs` | array | Category breadcrumb trail *(when `includeDetail`)* | | `application` | string | Intended application, e.g. `Kitchen` *(when `includeDetail`)* | | `handleType` | string | Handle type *(when `includeDetail`)* | | `scrapedAt` | string | ISO 8601 UTC scrape timestamp | ### Use cases - **Competitive price monitoring** — schedule daily runs on your key categories and diff `minPrice` / `maxPrice` and per‑finish `price` over time. - **Assortment & catalog sync** — pull an entire category (`categoryId`) to mirror brands, models, finishes, specs and imagery into your own store or PIM. - **Brand & MAP compliance** — filter by `brand` and compare `price` vs `msrp` per SKU. - **Availability tracking** — watch `finishes[].inStock` / `inventory` and `status`. - **Ratings intelligence** — rank products by `avgRating` and `reviewCount`. ### Input parameters | Field | Type | Default | Description | | --------------- | ------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | `keywords` | string | `kitchen faucet` | Product search term. Leave empty to scrape a category instead. | | `categoryId` | integer | — | Numeric leaf category ID (from a `/c` category URL). Used when `keywords` is empty. | | `sortOption` | string | `SCORE` | `SCORE`, `PRICE_LOW`, `PRICE_HIGH`, `NEWEST_TO_OLDEST`, `OLDEST_TO_NEWEST`. | | `maxItems` | integer | `100` | Stop after this many product rows. | | `includeDetail` | boolean | `false` | Fetch each product's detail page for description, full image gallery, breadcrumbs, application and handle type (one extra request per product). | #### Example input ```json { "keywords": "kitchen faucet", "sortOption": "PRICE_LOW", "maxItems": 100, "includeDetail": false } ``` Category mode: ```json { "categoryId": 51224, "sortOption": "SCORE", "maxItems": 500 } ``` #### Example output row ```json { "compositeId": 2036768, "model": "19867LF", "brand": "Delta", "title": "Nicoli 1.8 GPM Single Hole Pull Down Kitchen Faucet - Includes Escutcheon", "series": "Nicoli", "type": "Faucet", "productUrl": "https://www.fergusonhome.com/delta-19867lf/s2036768", "minPrice": 229.92, "maxPrice": 269.4, "minMsrp": 383.2, "maxMsrp": 449.0, "currency": "USD", "avgRating": 4.7467, "reviewCount": 75, "finishCount": 2, "finishes": [ { "uniqueId": 4883516, "name": "Brilliance Stainless", "sku": "19867LF-SS", "price": 229.92, "msrp": 383.2, "status": "stock", "inStock": true, "inventory": 1094, "image": "https://s2.img-b.com/build.com/imagebase/resized/330x320/deltaimages/delta-19867lf-ss-830805.jpg", "swatchHex": "CFD4D9" } ], "images": [ "https://s2.img-b.com/build.com/imagebase/resized/330x320/deltaimages/delta-19867lf-ss-830805.jpg" ], "specs": [{ "name": "Flow Rate (GPM)", "value": "1.8", "units": null }], "scrapedAt": "2026-08-26T12:00:00+00:00" } ``` ### Scheduling & webhooks Use **Schedules** to run the actor on a cron (e.g. daily price checks) and add a **webhook** on `ACTOR.RUN.SUCCEEDED` to push fresh rows into your database, Google Sheet, or downstream pipeline the moment a run finishes. ### Use from AI assistants (MCP) This actor is callable from AI agents through the **Apify MCP server**, so an assistant can fetch Ferguson Home product data on demand. Point your MCP‑enabled client (Claude, Cursor, VS Code, etc.) at `https://mcp.apify.com`, add this actor, and call it with the same input fields documented above. ### Export formats Results are stored in an Apify dataset and can be downloaded as **JSON, CSV, Excel, HTML or XML**, or pulled via the Apify API. ### FAQ **Where does the data come from?** Ferguson Home's own public product API — the same endpoints the mobile app uses. No login or personal data is accessed. **How fresh is it?** Every run fetches live data at request time (prices, stock and ratings reflect the moment of scraping). **How many products can I scrape?** From a few to tens of thousands — control it with `maxItems`. Very large jobs are paginated automatically and checkpoint their progress, so an interrupted run resumes without duplicating rows. **Do I need a proxy?** No. The API responds from any IP, so no proxy configuration is required. **Why are `description`, `breadcrumbs`, `application` and `handleType` empty?** They are only fetched when `includeDetail` is enabled. Prices, finishes, SKUs, ratings and specs are always included. **Is scraping this data legal?** The actor collects publicly available product information. You are responsible for using the data in compliance with applicable laws and Ferguson's terms. # Actor input Schema ## `keywords` (type: `string`): Product search term to scrape from Ferguson Home (e.g. "kitchen faucet", "led shower head", "delta bathroom faucet"). Leave empty to scrape a category by ID instead. ## `categoryId` (type: `integer`): Numeric leaf category ID to list products from (e.g. 51224). Mutually exclusive with keywords — if both are set, keywords wins. Find IDs from a fergusonhome.com category URL ending in /c (web and mobile share the same IDs). ## `sortOption` (type: `string`): How results are ordered. ## `maxItems` (type: `integer`): Stop after this many product rows have been pushed to the dataset. ## `includeDetail` (type: `boolean`): Fetch each product's detail page to add a plain-text description, the full image gallery, category breadcrumbs, application and handle type. Adds one extra request per product (slower, more thorough). Prices, finishes/SKUs, ratings and specs are always included without this. ## Actor input object example ```json { "keywords": "kitchen faucet", "sortOption": "SCORE", "maxItems": 100, "includeDetail": false } ``` # Actor output Schema ## `dataset` (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 = { "keywords": "kitchen faucet" }; // Run the Actor and wait for it to finish const run = await client.actor("axlymxp/ferguson-product-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 = { "keywords": "kitchen faucet" } # Run the Actor and wait for it to finish run = client.actor("axlymxp/ferguson-product-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": "kitchen faucet" }' | apify call axlymxp/ferguson-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,axlymxp/ferguson-product-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/8VIy9R5eWubZZ8Fay/builds/QemeO4kewf7pya2mm/openapi.json