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<id> 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

{
    "keywords": "kitchen faucet",
    "sortOption": "PRICE_LOW",
    "maxItems": 100,
    "includeDetail": false
}

Category mode:

{
    "categoryId": 51224,
    "sortOption": "SCORE",
    "maxItems": 500
}

Example output row

{
    "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.