# Wayfair Scraper (`mscraper/wayfair-scraper`) Actor

The Wayfair Scraper is a powerful tool built to scrape detailed product data from Wayfair. It can retrieve important product data such as product name, sku, manufacturer, rating, reviews, price, and more.

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

## Pricing

$20.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period. You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#rental-actors

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

## Wayfair scraper

### What does Wayfair Scraper do?

The Wayfair Scraper is a powerful tool built to scrape detailed product data from the [Wayfair](https://www.wayfair.com/). It can retrieve important product data such as product name, sku, manufacturer, rating, reviews, price, and more.

### Why scrape Wayfair?

Wayfair is a well-known online marketplace for furniture and home goods, offering an extensive selection of products across many categories. Here are four potential benefits of scraping data from Wayfair:

➡️ **Market Research**:
By scraping data from Wayfair, you can gain valuable insights into market trends, popular products, pricing strategies, and promotional offers. This information can guide business decisions and marketing strategies.

➡️ **Competitor Analysis**:
The data from Wayfair can provide an understanding of what products are being offered by a major competitor. This can help businesses in the same industry strategize and compete effectively.

➡️ **Price Monitoring**:
Wayfair's data can be used for price monitoring. This would allow a company to track changes in prices over time, providing insights into sales, discounts, and price fluctuations.

➡️ **Identifying Marketing Trends**:
Wayfair's promotional texts and sales events can provide insights into current marketing trends in the beauty industry. This data can be used to optimize marketing campaigns.

### How much will it cost to scrape Wayfair?

Apify gives you $5 free usage credits every month on the [Apify Free plan](https://apify.com/pricing). You can get up to 10,000 results per month from Wayfair Scraper for that, so those 10,000 results will be completely free

But if you need to get more data regularly from Wayfair, you should grab an Apify subscription. We recommend our [$49/month Starter plan](https://apify.com/pricing) - you can get up to 100,000 every month with the $49 monthly plan!

Or get 1,000,000 results for $499 with the [Scale plan](https://apify.com/pricing) - wow!

### How to scrape Wayfair?

It's easy to scrape Wayfair with Wayfair Scraper. Just follow these few steps and you'll get your data in a few minutes.

1. Click on Try for free.
2. Add URLs in input.
3. Click on Run.
4. When Wayfair Scraper has finished, preview or download your data from the Dataset tab.

Example of valid URLs:

`https://www.wayfair.com/furniture/sb0/kitchen-dining-tables-c46129.html`

`https://www.wayfair.com/filters/furniture/sb3/kitchen-dining-tables-c46129-a1277~8752-a75199~274655-a131799~442510.html`

`https://www.wayfair.com/bed-bath/pdp/ebern-designs-wynton-microfiber-reversible-3-piece-comforter-set-w002610239.html`

### Results

The output from Wayfair Scraper is stored in the dataset. After the run is finished, you can download the dataset in various data formats (JSON, CSV, XML, RSS, HTML Table).

PDP:

```json
{
 "type": "PDP",
 "marketingPromotion": null,
 "__typename": "Product",
 "sku": "W010559861",
 "name": "Dotsie Modern Round Dining Table for 6, Sintered Stone Tabletop with Lazy Susan, X Carbon Steel Base",
 "skuTypes": [],
 "quantity": {
  "defaultQuantity": 1,
  "displaySetQuantity": 1,
  "forcedQuantityMultiplier": 1,
  "minimumOrderQuantity": 1,
  "unitType": "REGULAR",
  "quantityPerUnit": 1
 },
 "promotionStatuses": [],
 "supportedPaymentTypes": [],
 "sale_banner": "",
 "percent_sold": null,
 "isCustomProduct": false,
 "hasOptionPartImagery": false,
 "restrictions": {
  "is_b2b_exclusive": false
 },
 "master_class": {
  "id": 147
 },
 "limitedTimeContent": {
  "copy": ""
 },
 "videos": [
  {
   "resourceId": 267460,
   "thumbnailImage": {
    "id": 242668609
   },
   "tracks": [
    {
     "url": "https://secure.img1-cg.wfcdn.com/media/video/tracks/26/267460.vtt",
     "kind": "captions",
     "mediaType": "text/vtt"
    },
    {
     "url": "https://secure.img1-cg.wfcdn.com/media/audio/26/267460.mp3",
     "kind": "descriptions",
     "mediaType": "audio/mpeg"
    },
    {
     "url": "https://secure.img1-cg.wfcdn.com/media/video/ad/26/267460.vtt",
     "kind": "descriptions",
     "mediaType": "text/vtt"
    }
   ],
   "posterImage": {
    "id": 242668609
   },
   "sources": [
    {
     "url": "https://secure.img1-cg.wfcdn.com/dm/video/5d52d4ff-6028-42fa-b0be-ac5a3c624f64/2023.4.11.1.mp4",
     "format": "video/mp4"
    }
   ],
   "duration": 22
  }
 ],
 "giftWithPurchase": null,
 "marketing_category": {
  "marketing_category_id": 62
 },
 "is_kit": false,
 "is_customized": false,
 "has_return_sale": false,
 "is_composite_sku": false,
 "customization": null,
 "optionConnection": {
  "metadata": {
   "categoryCount": 1,
   "optionCount": 2
  }
 },
 "manufacturer": {
  "id": 44325,
  "logo": {
   "id": 39633913
  },
  "details": "0",
  "name": "Orren Ellis",
  "shortName": "Orren Ellis",
  "url": "https://www.wayfair.com/brand/bnd/orren-ellis-b44325.html",
  "averageRating": 4.53,
  "pageContent": {
   "components": []
  }
 },
 "promo_text": "",
 "b_suppl_or_manu_discontinued": false,
 "special_sku_type": 0,
 "default_options": [
  599577216
 ],
 "option_exceptions": [],
 "manufacturerPartNumber": {
  "partNumber": "W010559861"
 },
 "display_info": {
  "environmentalManagementCosts": {
   "isEnabled": false,
   "fee": "$0.00"
  },
  "showWheelieBin": false,
  "badge": "",
  "features": [
   "Long Lifespan Marble tabletop presents premium texture and beauty on the surface. The 18mm resin-coated marble tabletop featuring scratch resistance and heat resistance (100 ℃ ) holds a hot pan without leaving any marks. We believe that without vandalism, this table can be used continuously for a long time.",
   "Boasting an X design, the black-finished carbon steel base is resistant to fade, rust, and corrosion.",
   "Environmental Protection 12mm sintered stone is an eco-friendly material that is certified by NSF and has no radiation.",
   "Environmental Protection 12mm sintered stone is an eco-friendly material that is certified by NSF and has no radiation.",
   "High-Temperature Resistant Constructed from superior sintered stone, this dining table is easy to clean with a damp cloth and resistant to heat up to 1200℃.",
   "Removeable lazy Susan 360° rotatable and detachable Lazy Susan brings much flexibility, making it ideal for both upscale dinner parties and casual morning meals.",
   "Rounded edge After handcrafted polishing, the round edge is sleek enough to provide a safe user experience, protecting you from bumping and crashing.",
   "Multi-layered solid wood panels The bottom of the table is reinforced with multi-layered solid wood panels and fixed with screws, ensuring long-lasting stability and reliability."
  ],
  "romanceCopy": "This simple white round-stone dining table makes your home looks more modern and elegant. 360° rotatable lazy Susan can be taken away to provide more dining space when not needed. X-shape carbon steel metal legs, avant-garde and full of design, only a discerning aesthetic can discover its unique beauty.",
  "flashDeals": null,
  "productSustainability": [],
  "dimensions": {
   "maxWidth": 51.18,
   "maxDepth": 0,
   "maxHeight": 29.53
  },
  "chemicalWarning": null,
  "energyCompliance": [],
  "additionalInformation": [
   {
    "tags": [
     {
      "title": "Top Material",
      "value": "Faux Marble",
      "units": "",
      "unitString": null
     }
    ]
   },
   {
    "tags": [
     {
      "title": "Base Material",
      "value": "Steel",
      "units": "",
      "unitString": null
     }
    ]
   },
   {
    "tags": [
     {
      "title": "Seating Capacity",
      "value": "6",
      "units": "",
      "unitString": null
     }
    ]
   },
   {
    "tags": [
     {
      "title": "Assembly Required",
      "value": "Yes",
      "units": "",
      "unitString": null
     }
    ]
   }
  ]
 },
 "concierge": {
  "isMessagingActive": true,
  "isPhoneActive": true
 },
 "related_item_meta_data": {
  "class_name": "",
  "class_explanation": "",
  "suggestion_type": 0,
  "source_type": 0,
  "is_exact_match": false,
  "collection_id": null,
  "related_class": {
   "related_class_id": null
  }
 },
 "three_d_info": null,
 "visualContent": [
  {
   "__typename": "visual_content_illustration",
   "image": {
    "id": 93043008
   },
   "imageHeader": "Table Height: 29.53 ''"
  },
  {
   "__typename": "visual_content_illustration",
   "image": {
    "id": 73362715
   },
   "imageHeader": "Commercial Use: Yes"
  }
 ]
}
```

Listing:

```json
{
 "banner_type": 0,
 "sku": "W007082856",
 "special_sku_type": 0,
 "name": "Modern High Gloss Halo Luxury Dining Table",
 "promo_text": "",
 "has_return_sale": true,
 "three_d_info": null,
 "inventory": {
  "stockStatus": "IN_STOCK"
 },
 "pricing": {
  "customerPrice": {
   "display": {
    "__typename": "SFPricing_SinglePrice",
    "value": 380,
    "measurement": "REGULAR",
    "currency": "USD",
    "label": "NONE"
   },
   "appliedPromotion": null
  },
  "listPrice": {
   "display": {
    "__typename": "SFPricing_SinglePrice",
    "value": 764.97,
    "measurement": "REGULAR",
    "currency": "USD",
    "label": "NONE"
   }
  },
  "previousSalePrice": null,
  "pricePerItem": null,
  "suggestedRetailPrice": null,
  "clearancePrice": null,
  "bulkPrice": {
   "maxPercentageOff": null,
   "currentTierDiscountDetail": null
  }
 },
 "display_info": {
  "storefrontProductEnergyLabel": {
   "energyEfficiencyClass": null,
   "energyEfficiencyClassRange": null
  },
  "romance_copy": "With a striking and contemporary design, this dining table is more than just a place to eat. Made from manufactured wood with a black tempered glass tabletop, this table has oval-shaped center support with a cutout design. It is made to be the centerpiece of a modern dining area and is sure to be a talking point.",
  "features_array": [
   "Beautiful design",
   "Stylish high gloss halo support",
   "Beautiful high gloss and glass dining table to modernize any home",
   "Designed and built to bring a stylish look into your home",
   "High quality finish runs throughout every piece in the dining table"
  ],
  "lnrs_trade_copy": null,
  "flashDeals": null
 },
 "optionConnection": {
  "metadata": {
   "size_option_count": 2,
   "color_option_count": 0,
   "other_option_count": 0
  }
 },
 "manufacturer": {
  "id": 40001,
  "name": "East Urban Home"
 },
 "shipping": {
  "messages": [
   {
    "type": "HEADLINE",
    "text": "Free shipping",
    "subTexts": [],
    "programs": [
     "FREE_SHIPPING"
    ],
    "restrictions": []
   }
  ]
 },
 "customer_reviews": {
  "average_rating_value": 4.61,
  "b_kit_carousel_enabled": false,
  "b_private_sale": false,
  "filter_rating": null,
  "current_tag": null,
  "current_regex": null,
  "image_150w_150h_url": null,
  "rating_count": 93,
  "rating_discrete": 4.5,
  "review_count": 10,
  "review_page": 1,
  "review_pages_total": 10,
  "review_sort_order": "relevance",
  "sku": "EBOX9079",
  "rating_relevancy": 0,
  "full_review_count": 93,
  "use_manufacturer_reviews": false
 },
 "samplesMetadata": {
  "hasSamples": false,
  "singleSamplePrice": 0
 },
 "sponsoredData": null,
 "leadImage": {
  "id": 121957840
 },
 "url": "https://www.wayfair.com/furniture/pdp/modern-high-gloss-halo-luxury-dining-table-w007082856.html"
}
```

#### Note

I can add more information ex. price, inventory status, compatible items, a review summary, and reviews. Let me know if you need some of this information (data available in separate requests).

### Is it legal to scrape Wayfair?

Note that personal data is protected by GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. We also recommend that you read our blog post: [is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/)

### Contact

Please feel free to browse through the diverse array of web scrapers available on [my Apify profile](https://apify.com/mscraper). If a custom solution or extra options are what you're seeking, don't hesitate to get in touch with me directly at <contact@mscraper.com>.

# Actor input Schema

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

URLs to start with.

## `proxy` (type: `object`):

Select proxies to be used by your crawler.

## `includeDetails` (type: `boolean`):

No description

## `resultsLimit` (type: `integer`):

Maximum number of results

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.wayfair.com/furniture/sb0/kitchen-dining-tables-c46129.html"
    },
    {
      "url": "https://www.wayfair.com/bed-bath/pdp/ebern-designs-wynton-microfiber-reversible-3-piece-comforter-set-w002610239.html"
    }
  ],
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyCountry": "US"
  },
  "includeDetails": false,
  "resultsLimit": 50
}
```

# 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 = {
    "startUrls": [
        {
            "url": "https://www.wayfair.com/furniture/sb0/kitchen-dining-tables-c46129.html"
        },
        {
            "url": "https://www.wayfair.com/bed-bath/pdp/ebern-designs-wynton-microfiber-reversible-3-piece-comforter-set-w002610239.html"
        }
    ],
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyCountry": "US"
    },
    "resultsLimit": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("mscraper/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 = {
    "startUrls": [
        { "url": "https://www.wayfair.com/furniture/sb0/kitchen-dining-tables-c46129.html" },
        { "url": "https://www.wayfair.com/bed-bath/pdp/ebern-designs-wynton-microfiber-reversible-3-piece-comforter-set-w002610239.html" },
    ],
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyCountry": "US",
    },
    "resultsLimit": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("mscraper/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 '{
  "startUrls": [
    {
      "url": "https://www.wayfair.com/furniture/sb0/kitchen-dining-tables-c46129.html"
    },
    {
      "url": "https://www.wayfair.com/bed-bath/pdp/ebern-designs-wynton-microfiber-reversible-3-piece-comforter-set-w002610239.html"
    }
  ],
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyCountry": "US"
  },
  "resultsLimit": 50
}' |
apify call mscraper/wayfair-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,mscraper/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/2ZZIl82hsQt3oPJRq/builds/5RC2zQ6XZWp0VvkYw/openapi.json