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

> Returns Wayfair products matching a keyword, 48 per page by default, each with its SKU, name, brand, current and list price, star rating, review count, product URL, image, a short product description, and attribute highlights such as swivel or adjustable height. Feed a returned SKU into GET /v1/wayfair/product for full detail or GET /v1/wayfair/reviews for customer reviews. Two things to expect when crawling: consecutive pages repeat roughly a quarter of their rows because Wayfair reorders results between calls, so de-duplicate on product.id; and the result total Wayfair reports drifts between pages, so it is not returned here. Paginate until a page comes back empty.

TL;DR: `GET /v1/wayfair/search` 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 |
| --- | --- | --- |
| `query` | yes | Free-text product search, for example office chair or velvet sofa. |
| `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. |
| `items_per_page` | no | Rows per page: 24, 48 (default), or 96. (24 \| 48 \| 96) |
| `sort_by` | no | Result ordering: relevance (default), price_low, price_high, top_rated, or newest. (relevance \| price_low \| price_high \| top_rated \| newest) |
| `min_price` | no | Lowest price to include. Applied by Wayfair and approximate, so filter on product.price.current if you need a hard bound. |
| `max_price` | no | Highest price to include. Applied by Wayfair and approximate, so filter on product.price.current if you need a hard bound. |
| `color` | no | Restrict results to one colour family, for example grey. |
| `in_stock` | no | Set true to return only products Wayfair can ship now. |

## Code example

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

## FAQ

### How many products come back per page?

Forty-eight by default. You can ask for 24, 48 or 96 with the items per page parameter, and page through with the universal cursor.

### Can I filter Wayfair search by price?

Yes, with a minimum and maximum price. Wayfair applies these approximately, so filter on the returned current price if you need a hard bound.

### Do search rows include a product description?

Yes. Search rows carry a genuine description snippet, which is more useful than the detail endpoint's field because that one is retailer marketing copy.

### Is the result total reliable?

No, and we do not return it. Wayfair's reported total drifts between consecutive pages, so paginate until a page comes back empty instead.

### How do I sort Wayfair search results?

Sort by relevance, price low to high, price high to low, top rated or newest. Relevance is the default when you send nothing.

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 search Wayfair products with an API?
- How to find Wayfair SKUs programmatically
- Can I filter Wayfair search results by price?