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

> Returns written customer reviews for a Wayfair product, 10 per page, each with the review text, star rating, reviewer name and location, submission date, verified-purchase flag, and any reviewer photos. Pages do not overlap and the review total is stable across pages, so a full crawl is deterministic: pass the returned cursor back until has_more is false. Wayfair does not publish helpful-vote counts or review headlines, so those fields are always null here.

TL;DR: `GET /v1/wayfair/reviews` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `sku` | yes | Wayfair product SKU, the alphanumeric id at the end of a wayfair.com product URL: wayfair.com/furniture/pdp/<name>-w003564166.html is SKU W003564166. SKUs also come back on every row of GET /v1/wayfair/search. |
| `country` | no | Wayfair marketplace as a two-letter country code: US (wayfair.com, default), CA, GB, IE, or DE. A SKU from one marketplace will not always resolve in another. (US \| CA \| GB \| IE \| DE) |
| `page` | no | Page number, starting at 1. Prefer the universal cursor parameter. |
| `sort_order` | no | Review ordering: relevance (default), helpful, date_ascending, date_descending, rating_ascending, or rating_descending. (relevance \| helpful \| date_ascending \| date_descending \| rating_ascending \| rating_descending) |
| `star` | no | Return only reviews with this star rating, 1 to 5. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/wayfair/reviews?sku=W003564166" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How many reviews come back per page?

Ten, which is fixed by Wayfair. Pass the returned cursor back to walk the rest until there are no more pages.

### Do pages overlap when I crawl?

No. Page one and page two share no review ids, and the review total holds steady across pages, so a full crawl is predictable.

### Is the verified-purchase flag accurate?

Yes. We read it from Wayfair's verified purchase badge rather than its own boolean field, which is left unpopulated on every row we measured.

### Can I filter reviews by star rating?

Yes, pass a star value from one to five. You can also sort by relevance, helpfulness, date or rating in either direction.

### Are reviewer photos included?

Yes, as an array of image URLs on each review that has them, and null on reviews that do not.

See the full Wayfair API: https://www.socialcrawl.dev/platforms/wayfair

## 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 pull Wayfair customer reviews with an API?
- Can I filter Wayfair reviews by star rating?
- Do Wayfair review pages repeat the same reviews?