# Wayfair Data API (https://www.socialcrawl.dev/platforms/wayfair)

> Wayfair lists millions of furniture and decor SKUs and publishes no public API. SocialCrawl covers it with 3 endpoints: keyword search, full product detail by SKU, and paginated customer reviews. Every response uses the same canonical product and review shapes as our Amazon, Walmart and Target endpoints, so a price comparison across retailers reads identical leaf names.

TL;DR: SocialCrawl's Wayfair API exposes 3 endpoints, 5 credits per call, all returning one unified JSON schema with AI-enriched fields. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Search | GET | `/v1/wayfair/search` | 5 | Search Wayfair products |
| Product | GET | `/v1/wayfair/product` | 5 | Get a Wayfair product by SKU |
| Reviews | GET | `/v1/wayfair/reviews` | 5 | Get Wayfair product reviews |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/wayfair/search?query=office%20chair" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## FAQ

### What is a Wayfair SKU and where do I find one?

A Wayfair SKU is the alphanumeric id at the end of a product URL: wayfair.com/furniture/pdp/<name>-w003564166.html is SKU W003564166. Every row returned by the search endpoint also carries its SKU.

### Does the Wayfair API return prices?

Yes. Both search rows and product detail return the current price and, where the item is discounted, the list price it was reduced from, plus the currency for the marketplace you queried.

### Which Wayfair marketplaces are supported?

The US site plus Canada, the UK, Ireland and Germany, selected with a two-letter country code. A SKU from one marketplace will not always resolve in another, so keep the country consistent across calls.

### Can I crawl every result page for a search?

You can, but de-duplicate on product id as you go. Wayfair reorders results between requests, so consecutive pages repeat roughly a quarter of their rows, and the result total it reports drifts between pages.

### Do Wayfair reviews include helpful votes?

No. Wayfair does not publish helpful-vote counts or review headlines anywhere, so those fields are always null. You do get the review text, star rating, reviewer name and location, date, verified-purchase flag and photos.

### Why does the review count differ between search and product?

They count different things. Product detail reports reviews on the selected variant, while a search row reports the whole catalogue entry. Both are accurate for their own surface, so we publish each where it was measured.

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get Wayfair product data with an API?
- What is a Wayfair SKU and how do I look it up?
- How to track Wayfair prices programmatically
- How do I pull Wayfair customer reviews without scraping?