# Wayfair Furniture & Home Goods Scraper (`parseforge/wayfair-scraper`) Actor

Scrape Wayfair product listings from search queries, category pages, and brand URLs. Returns each product as a flat row with price, rating, SKU, and availability. Supports price filtering and sort order.

- **URL**: https://apify.com/parseforge/wayfair-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** E-commerce
- **Stats:** 18 total users, 5 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

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

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### Wayfair Furniture & Home Goods Scraper

**Scrape Wayfair product listings from any search, category, or brand URL, up to a million items per run.** Every product comes with its price, rating, SKU, and full specs. No login or API key. Export to CSV, JSON, Excel, or XML.

Wayfair's catalog spans millions of furniture and home goods items across thousands of brands, but manually copying prices and specs is slow and error-prone. This Actor reads the public product feeds directly, searching by keyword or browsing by category and brand URLs, and returns each match in one consistent schema. It handles pagination, sorting, and price filtering so you get exactly the slice of the catalog you need.

| Who uses it | What they scrape Wayfair for |
|---|---|
| E-commerce pricing analysts | Monitor competitor and supplier price changes across Wayfair's furniture categories. |
| Dropshippers and resellers | Build product feeds with current prices, stock status, and images for their own storefronts. |
| Market researchers | Track which styles, materials, and brands are trending in home goods. |
| Brand managers | Audit their own product listings and MAP pricing compliance on Wayfair. |

### What it does

This Actor collects Wayfair product listings by search query or direct URL and returns each one as a flat row with price, rating, SKU, and availability.

- 🔍 **Keyword search:** type any product term like "sectional sofa" or "office desk" and the Actor runs the search for you.
- 🔗 **Direct URLs:** paste category browse pages, search result pages, or brand pages and pagination follows automatically.
- 💰 **Price filtering:** set a min and max price in USD so only products in your budget reach the dataset.
- 📊 **Sort control:** order results by relevance, price low-to-high or high-to-low, top rated, or newest arrivals.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with Wayfair data

**📈 Monitor competitor pricing.**

A pricing analyst runs the Actor weekly on a list of category URLs to track price movements on sofas and dining tables and flags undercuts.

**🛒 Build a dropshipping feed.**

A reseller scrapes the "office furniture" search results, filters to items under $500, and exports a CSV to upload to their own store.

**🏷️ Audit brand presence.**

A furniture brand manager searches their own brand name to verify product titles, images, and prices are correct across all Wayfair listings.

**📊 Research home decor trends.**

A market analyst scrapes the "newest" sort for "rugs" and "lighting" each month to spot emerging colors and materials.

### Why choose this scraper

| | What you get |
|---|---|
| **No API key or registration** | Reads the public Wayfair pages directly, no developer account needed. |
| **Fixed flat schema** | Every product row has the same columns, ready for spreadsheets and databases. |
| **Automatic pagination** | Scrolls through every page of results so you do not miss items. |
| **Price and sort filters** | Narrow the run to a price band and control the result order before scraping. |

### How it compares

This Actor focuses on fast, high-volume listing collection with price filtering and sort control built into the run, while other Wayfair scrapers emphasize deep product detail or specific regional catalogs.

| Feature | ParseForge | Furniture & Home Goods Product Data - Wayfair | Wayfair Scraper - Furniture Prices, Specs & Reviews | Wayfair UK Scraper - Furniture & Home Products |
|---|---|---|---|---|
| Keyword search input | Yes | Not listed | Yes | Yes |
| Category and brand URL input | Yes | Not listed | Yes | Not listed |
| Price range filter (min/max) | Yes | Not listed | Not listed | Not listed |
| Sort order control | Yes | Not listed | Not listed | Not listed |
| Full product descriptions and specs | Not listed | Yes | Yes | Not listed |
| wayfair.co.uk support | Not listed | Not listed | Not listed | Yes |

### Configure the run

Drive the Actor from search queries and direct Wayfair URLs, alone or together, and price filters run as each product is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

```json
{
 "searchQueries": [
 "sectional sofa",
 "office desk",
 "dining table"
 ],
 "startUrls": [],
 "maxItems": 10
}
```

A larger pull:

```json
{
 "searchQueries": [
 "sectional sofa",
 "office desk",
 "dining table"
 ],
 "startUrls": [],
 "maxItems": 200
}
```

### Pricing

Pay-per-result: **$0.04 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $4.00 |
| 1,000 results | $40.00 |
| 10,000 results | $400.00 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [Wayfair Furniture & Home Goods Scraper](https://apify.com/parseforge/wayfair-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to Wayfair through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/wayfair-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check that your search query or URL is valid on wayfair.com. Also verify your price filters are not too narrow. Try running without minPrice and maxPrice to see if results appear.

**The Actor is running but collecting fewer products than I expected.**

Wayfair may have fewer listings for that query than your maxItems setting. Also, price filters remove items before they are counted. Try broadening your search terms or removing the price bounds.

**Some product fields are empty in my dataset.**

Not every Wayfair listing includes every detail. Ratings, review counts, or sale prices are only present when Wayfair displays them on the listing page.

**The run stopped early with an error.**

Wayfair may have temporarily blocked the request rate. The Actor includes automatic retries. If the problem persists, try reducing the maxItems or running during a less busy time.

**Can I get product descriptions and full specifications?**

This Actor returns the data visible on search and category listing pages. For full product descriptions, dimensions, and materials, you need an Actor that visits each product detail page.

### FAQ

| Question | Answer |
|---|---|
| Can I scrape a specific brand's entire catalog on Wayfair? | Yes. Paste the brand's page URL into the startUrls field and the Actor will follow every page of that brand's products. |
| Does this Actor handle Wayfair's variant products, like different sizes or colors? | The Actor returns the product as listed on the search or category page. For full variant details, you would need to follow each product URL separately. |
| Can I scrape Wayfair's international sites like wayfair.co.uk or wayfair.ca? | This Actor is built for wayfair.com. For wayfair.co.uk, use the dedicated Wayfair UK Scraper available on Apify. |
| How do I filter by price? | Set the minPrice and maxPrice fields in the input. The Actor applies these as it reads each product, so only items within your range are saved. |
| What does the sortBy option do? | It sets the sort order on Wayfair's own search and category pages before scraping. You can choose relevance, price ascending or descending, top rated, or newest. |
| Is there a limit on how many products I can scrape? | You set the limit with the maxItems field, up to 1,000,000 products per run. The Actor stops cleanly once it reaches that count. |
| Can I run multiple search queries in one run? | Yes. Add as many terms as you like to the searchQueries list. Each one runs as its own search and results are combined into one dataset. |
| Does this Actor log in to Wayfair? | No. It reads the publicly available product listing pages. No Wayfair account or login is needed. |
| What format is the exported data? | You can export your dataset as CSV, JSON, Excel, or XML directly from the Apify run console. |
| Can I schedule this Actor to run automatically? | Yes. Apify's scheduler lets you set the Actor to run hourly, daily, or weekly so your pricing data stays fresh without manual work. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Wayfair LLC. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords to search on Wayfair (e.g. "sectional sofa", "office desk"). Each keyword is run as its own search.

## `startUrls` (type: `array`):

Direct Wayfair URLs to scrape (category browse pages, search result pages, or brand pages). Pagination is followed automatically.

## `maxItems` (type: `integer`):

How many products to collect per run.

## `sortBy` (type: `string`):

Sort order applied to search and category result pages.

## `minPrice` (type: `integer`):

Minimum product price filter in USD. Leave empty for no lower bound.

## `maxPrice` (type: `integer`):

Maximum product price filter in USD. Leave empty for no upper bound.

## Actor input object example

```json
{
  "searchQueries": [
    "sectional sofa",
    "office desk",
    "dining table"
  ],
  "startUrls": [],
  "maxItems": 10,
  "sortBy": "relevance"
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset with all scraped items

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "sectional sofa",
        "office desk",
        "dining table"
    ],
    "startUrls": [],
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/wayfair-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": [
        "sectional sofa",
        "office desk",
        "dining table",
    ],
    "startUrls": [],
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/wayfair-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 '{
  "searchQueries": [
    "sectional sofa",
    "office desk",
    "dining table"
  ],
  "startUrls": [],
  "maxItems": 10
}' |
apify call parseforge/wayfair-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/wayfair-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 <APIFY_API_TOKEN>` 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/CkpnSLcLUcSgMmSdX/builds/8mFW4an5Jf9Vrohb8/openapi.json
