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

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