Wayfair API & Scraper
The Wayfair API returns wayfair.com, the largest US online home-goods retailer, as clean JSON in seven actions.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
search takes a keyword and returns Wayfair's whole result grid, 48 listings a page, and category/products does the same for a category id such as 413892 for Sofas, while brand/products returns everything Wayfair publishes for one house or partner brand such as Latitude Run. Every row on all three carries the SKU, title, brand, product URL, price, was-price, sale badge, currency, star rating, review count, the colour or fabric that price is for, the item's other options with their own product URLs and images, the number of options, the stock message Wayfair prints on the grid such as 252 Left in Stock, the delivery promise and method, the sponsored flag and the images. filters returns every facet Wayfair offers for a keyword or a category, each option carrying the id needed to apply it, plus the price buckets, the sort ids the page offers and the neighbouring categories, and facets stack as AND: Sofas alone was 278,015 listings, Sofas with Genuine Leather and Seats 3 was 1,173, and the two first pages shared 0 of 48 rows. product/detail returns the full record for one SKU: price and was-price, sale badge, stock status, delivery promise, description, the specification table, structured dimensions and weight, assembly, warranty, certifications, breadcrumbs, the manufacturer part number when the listing has one, every image and every colour, fabric and size option with its own URL and stock status. product/reviews returns the star average, the review count, Wayfair's own AI summary of what customers say, the sentiment aspects and the five reviews the product page serves. product/options is the pricing action: Wayfair prices each option separately, so one sofa measured $264.99 in Gray, $289.99 in Cream, $499.99 in Light Gray and $269.99 in Green, and this action reads each option's own price and reports price_min, price_max and prices_vary. Measured on 2026-09-24 over 1,440 live listing rows, the SKU, title, brand, URL, currency, rating, review count, price, option count, stock message and images came back on every row, and across 12 products from 12 different result sets the price, stock status, description, specification table, dimensions, breadcrumbs and images came back 12 times out of 12. No Wayfair account, no browser, one ReefAPI key and the standard { ok, data, meta, error } envelope.
On Wayfair the price belongs to the colour, not to the product
Wayfair sells the same item under many option combinations and prices each one separately. A single price for a listing is therefore the price of one option, the one the page happened to be showing. Every row and every product record names the option its price is for, and product/options reads each option's own price. These four were read one page per option on 2026-09-24.
| Option of listing W111515578 | option_id | Price |
|---|---|---|
| Gray | 1945754497 | $264.99 |
| Cream | 1945743990 | $289.99 |
| Light Gray | 1945754502 | $499.99 |
| Green | 1945754496 | $269.99 |
The dearest fabric of that sofa costs 89% more than the cheapest. On 12 listings priced this way, all 11 that have options priced them differently, with one spanning $589.99 to $1,640.00 across six options and the twelfth sold in a single configuration. options[].price is null on search, category/products, brand/products and product/detail on purpose: copying the shown price down to the siblings would invent prices out of one.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/wayfair/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "sofa"
}
}{
"ok": true,
"meta": {
"api": "wayfair",
"endpoint": "search",
"mode": "live",
"latency_ms": 3830.9,
"record_count": 48,
"bytes": 3701123,
"cache_hit": false,
"charged_credits": 2,
"version": "0.1.0"
},
"data": {
"results": [
{
"position": 1,
"sku": "W110562316",
"variant_sku": "W110562316_880809770",
"variant_id": "AL68081169",
"option_id": "880809770",
"title": "Oliver Upholstered Sofa",
"brand": "Ebern Designs",
"url": "https://www.wayfair.com/furniture/pdp/ebern-designs-oliver-upholstered-sofa-w110562316.html?piid=880809770",
"price": 469.99,
"was_price": 699.99,
"currency": "USD",
"sale_label": "Sale",
"price_is_from": false,
"loyalty_savings": 94,
"rating": 4.43,
"review_count": 2497,
"selected_options": [
{
"name": "[trimmed-depth]",
"category": "[trimmed-depth]"
}
],
"option_count": 17,
"options": [
{
"option_id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"variant_id": "[trimmed-depth]",
"url": "[trimmed-depth]",
"image": "[trimmed-depth]",
"price": "[trimmed-depth]"
},
{
"option_id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"variant_id": "[trimmed-depth]",
"url": "[trimmed-depth]",
"image": "[trimmed-depth]",
"price": "[trimmed-depth]"
},
{
"option_id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"variant_id": "[trimmed-depth]",
"url": "[trimmed-depth]",
"image": "[trimmed-depth]",
"price": "[trimmed-depth]"
}
],
"stock_message": "604 Left in Stock",
"delivery_promise": "FREE Fast Delivery",
"delivery_method": "Ground Delivery",
"is_sponsored": true,
"is_best_value": true,
"images": [
"https://assets.wfcdn.com/im/0/resize-h800-w800%5Ecompr-r85/2733/273390357/default_name.jpg",
"https://assets.wfcdn.com/im/0/resize-h800-w800%5Ecompr-r85/3900/390010907/default_name.jpg"
],
"marketing_copy": "This sofa brings a modern feel to your living room or office with its clean lines and square arms. The frame is made from a blend of solid and engineered wood, while its base features a mix of wood and metal for support. It is wrapped in polyester-linen upholstery and filled with high-density foam for a comfortable seat during movie nights or morning coffee. Removable back and seat cushions make it easy to vacuum away crumbs. Plus, the deep-seated design provides extra room for you to curl up and relax."
},
{
"position": 2,
"sku": "W006759421",
"variant_sku": "W006759421_1714157758",
"variant_id": "BQ04011156",
"option_id": "1714157758",
"title": "Barton 80.31'' Faux Leather Square Arm Sofa",
"brand": "Ebern Designs",
"url": "https://www.wayfair.com/furniture/pdp/ebern-designs-barton-8031-faux-leather-square-arm-sofa-w006759421.html?piid=1714157758",
"price": 399.99,
"was_price": 699.99,
"currency": "USD",
"sale_label": null,
"price_is_from": false,
"loyalty_savings": 40,
"rating": 4.49,
"review_count": 1357,
"selected_options": [
{
"name": "[trimmed-depth]",
"category": "[trimmed-depth]"
}
],
"option_count": 5,
"options": [
{
"option_id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"variant_id": "[trimmed-depth]",
"url": "[trimmed-depth]",
"image": "[trimmed-depth]",
"price": "[trimmed-depth]"
},
{
"option_id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"variant_id": "[trimmed-depth]",
"url": "[trimmed-depth]",
"image": "[trimmed-depth]",
"price": "[trimmed-depth]"
},
{
"option_id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"variant_id": "[trimmed-depth]",
"url": "[trimmed-depth]",
"image": "[trimmed-depth]",
"price": "[trimmed-depth]"
}
],
"stock_message": "619 Left in Stock",
"delivery_promise": "FREE Delivery",
"delivery_method": "Ground Delivery",
"is_sponsored": true,
"is_best_value": true,
"images": [
"https://assets.wfcdn.com/im/0/resize-h800-w800%5Ecompr-r85/4306/430660494/default_name.jpg",
"https://assets.wfcdn.com/im/0/resize-h800-w800%5Ecompr-r85/3705/370591211/default_name.jpg"
],
"marketing_copy": "This faux leather sofa anchors your living space with a clean mid-century modern silhouette. It's crafted with a solid and engineered wood frame, and it rests on tapered solid wood legs for a retro look. The pocket spring seat construction and foam-filled cushions offer support while you read or relax with family. Track arms bring a crisp, tailored feel that updates your home's aesthetic without overpowering existing decor. The synthetic material provides a smooth surface that stands up to regular use. Plus, the removable cushion covers make regular maintenance a breeze."
},
{
"position": 3,
"sku": "W112266288",
"variant_sku": "W112266288_2140780284",
"variant_id": "BF16013401",
"option_id": "2140780284",
"title": "Traditional Upholstered Standard Sofa with Square Armrests and 2 Throw Pillows",
"brand": "Ebern Designs",
"url": "https://www.wayfair.com/furniture/pdp/ebern-designs-traditional-upholstered-standard-sofa-with-square-armrests-and-2-throw-pillows-w112266288.html?piid=2140780284",
"price": 539.99,
"was_price": 1333.99,
"currency": "USD",
"sale_label": null,
"price_is_from": false,
"loyalty_savings": 108,
"rating": 4.26,
"review_count": 824,
"selected_options": [
{
"name": "[trimmed-depth]",
"category": "[trimmed-depth]"
}
],
"option_count": 9,
"options": [
{
"option_id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"variant_id": "[trimmed-depth]",
"url": "[trimmed-depth]",
"image": "[trimmed-depth]",
"price": "[trimmed-depth]"
},
{
"option_id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"variant_id": "[trimmed-depth]",
"url": "[trimmed-depth]",
"image": "[trimmed-depth]",
"price": "[trimmed-depth]"
},
{
"option_id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"variant_id": "[trimmed-depth]",
"url": "[trimmed-depth]",
"image": "[trimmed-depth]",
"price": "[trimmed-depth]"
}
],
"stock_message": "21 Left in Stock",
"delivery_promise": "FREE Delivery",
"delivery_method": "Ground Delivery",
"is_sponsored": false,
"is_best_value": true,
"images": [
"https://assets.wfcdn.com/im/0/resize-h800-w800%5Ecompr-r85/3093/309329673/default_name.jpg",
"https://assets.wfcdn.com/im/0/resize-h800-w800%5Ecompr-r85/3093/309329658/default_name.jpg"
],
"marketing_copy": "This modern sofa introduces clean lines and a tailored silhouette that updates your layout. It's crafted with a sturdy solid wood frame to supply a reliable seating foundation across your home. The square armrests give the piece a crisp look, while fabric upholstery wraps the clean-lined frame to deliver a smooth surface. Thick foam-padded seat cushions provide supportive comfort for reading, streaming, or unwinding after a long day. This seating choice fits smoothly into various decor styles. It also seats three people comfortably for gathering with friends or relaxing with family."
}
],
"count": 48,
"page_kind": "search_results",
"page_note": null,
"total_results": 278440,
"page": 1,
"per_page": 48,
"has_more": true,
"resolved_url": "https://www.wayfair.com/furniture/sb0/sofas-c413892.html?redir=sofa&rtype=9",
"pagination_note": "Wayfair's default order on a search or category grid is recommendation-based and is not stable between requests, so consecutive pages can repeat a dozen or so listings — measured 12 to 15 of 48. De-duplicate on `sku`. Brand pages do not have this problem: pages 1, 2 and 3 of one brand shared nothing.",
"option_price_note": "Each option is priced separately by Wayfair; `options[].price` is null here — call product/options for per-option prices.",
"query": "sofa",
"resolved_category": {
"category_id": "413892",
"name": "Sofas"
},
"filters_applied": []
}
}What the Wayfair API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Wayfair by keyword and read the whole result grid. 48 listings per page with price, was-price, sale badge, brand, rating and review count, the selected colour or fabric, the other options with their own product URLs, stock message and delivery promise. Wayfair's own facets can be applied with `filters`. | Pricing teams call search to search Wayfair by keyword and read the whole result grid. | query, page, filters, max_rotations |
| category/products | Browse one Wayfair category — the same 48-listing grid as search, for a category id. Facets stack with `filters`: Sofas alone is 278,015 listings, Sofas + Genuine Leather + Seats 3 is about 1,170, and the two result sets do not overlap at all on page 1. | Marketplace operators call category/products to get browse one Wayfair category. | category, page, filters, max_rotations |
| brand/products | Every listing Wayfair publishes for one of its house or partner brands (Mercer41, Latitude Run, AllModern…), by brand id or brand-page URL. | Catalog enrichment teams call brand/products to get every listing Wayfair publishes for one of its house or partner brands (Mercer41, Latitude Ru…. | brand, page, max_rotations |
| filters | Every facet Wayfair offers for a keyword or a category, with the ids needed to build a filtered call: material, colour, size, brand, style, seating capacity, customer rating, availability, assembly, sustainability and the rest — plus the price buckets, the sort options the page offers, and the neighbouring categories. | Retail analysts call filters to get every facet Wayfair offers for a keyword or a category, with the ids needed to build a filter…. | query, category, filters, max_rotations |
| product/detail | The full Wayfair product record for one SKU (and, when given, one option): title, brand, price and was-price, sale badge, rating and review count, stock, delivery promise, description, the specification table, structured dimensions and weight, assembly, warranty, certifications, breadcrumbs, every image, and every colour / fabric / size option with its own product URL and stock status. | Pricing teams call product/detail to get the full Wayfair product record for one SKU (and, when given, one option). | sku, option_id, max_rotations |
| product/reviews | The review block Wayfair serves on a product page: the star average, the review count, Wayfair's own AI summary of what customers say, the sentiment aspects, and the five most recent reviews with rating, body, date, reviewer and incentive badge. The source serves only those five without an account — `has_more_on_source` says whether more exist. | Marketplace operators call product/reviews to get the review block Wayfair serves on a product page. | sku, option_id, max_rotations |
| product/options | Every option of a listing WITH ITS OWN PRICE. Wayfair prices each colour and size separately — one sofa measured $264.99 / $289.99 / $499.99 / $269.99 across four fabrics — and only the option's own page carries its price, so this action reads them. Costs one upstream page per option, which is why it is priced above `product/detail`. | Catalog enrichment teams call product/options to get every option of a listing WITH ITS OWN PRICE. | sku, max_options, max_rotations |
Call search from your stack
curl -X POST https://api.reefapi.com/wayfair/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"sofa"}'import requests
r = requests.post(
"https://api.reefapi.com/wayfair/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "sofa"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/wayfair/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "sofa"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.wayfair.search with {"query":"sofa"}.Who uses this API and why
- Track a Wayfair listing per colour and size, because the same sofa measured 89% dearer in one fabric than another.
- Watch where your furniture or homeware products sit in Wayfair's category grids and what the competing listings charge.
- Pull a category's whole facet tree to see how Wayfair classifies material, colour, size, style, seating capacity and assembly.
- Enrich a product catalogue with the specification table, structured dimensions, weight, assembly and warranty without opening a browser.
- Read a product's star average, Wayfair's AI review summary and the sentiment aspects to score a listing before you stock it.
Questions developers ask before integrating
Which Wayfair site does this cover?
wayfair.com, the United States site, priced in USD. The catalogue and the prices were identical on every reading, so there is no country parameter to set. Wayfair's other national domains are not covered by this engine.
Can I sort Wayfair results by price or rating?
No, and the reason was measured rather than assumed. Wayfair's page offers Recommended, Customer Rating and Price Per Item ascending and descending, but the sorted grid is built by the page after it loads, so the choice cannot be requested. Six different sort keys were tried and the server echoed Recommended for all six, with returned prices not monotonic under any of them. Rather than take a sort parameter and quietly ignore it, no action has one, and filters reports the sort ids Wayfair offers together with a note saying why they cannot be used. Filters are a different story: those apply, and they cut the result count hard.
How do I filter a Wayfair search or category?
Call filters with a keyword or a category id. You get back every facet Wayfair publishes with its ids, so a selection is a ready-made token such as 2470~7175 for Material: Genuine Leather. Pass those tokens to search or category/products in filters and several stack as AND. Across 11 measured calls the endpoint returned 306 facets, 280 of them with selectable option ids and 11 of them numeric ranges reported as buckets. Price is the exception: Wayfair publishes it as a range with buckets and no option id, so the buckets are reported and a price range is not accepted.
Why do Wayfair page 1 and page 2 share some listings?
Wayfair's default order on a search or category grid is recommendation-based and is not stable between requests, so consecutive pages repeat a dozen or so rows. Measured at 12 to 15 of 48. Every listing response says so in pagination_note. De-duplicate on sku. Brand pages do not have the problem: pages 1, 2 and 3 of one brand were 48 rows each and shared nothing.
Why is options[].price null on a search row?
Because Wayfair only carries an option's price on that option's own page. The row's price is the price of the selected colour or fabric, and the siblings come back with their id, name, image, URL and stock status but no price. Every listing response repeats this in option_price_note. product/options fetches the option pages and fills the prices, up to ten options per call with max_options, which is why it costs more than product/detail.
How many Wayfair reviews come back?
The five the product page serves, plus the star average, the total review count, Wayfair's own AI summary of the reviews and the sentiment by aspect. Over 60 reviews from 12 products, the review id, rating, body, date, author and incentive badge came back on 60 of 60, the reviewer's location on 46 and the option they bought on 4, because Wayfair leaves that field empty on most reviews. The summary and the aspects arrived on 11 of 12 products. Beyond the first five, the reviews are only reachable inside Wayfair's own page after it loads, so has_more_on_source tells you whether more exist rather than pretending to page through them.
What does Wayfair not publish?
A barcode: no GTIN and no UPC anywhere on any surface. A seller name, because Wayfair sells as the retailer of record. A delivery date, only the promise it prints such as FREE Delivery with Ground Delivery, and no postcode-specific estimate on the logged-out page. The manufacturer part number is a real field that most listings leave empty, published on 4 of 12 products in one sample and 0 of 13 in another, and it comes back null rather than being dropped. The N Left in Stock line is a grid field and is absent from the product page on 12 of 12, where stock_status is the answer instead.
What happens if I pass a top-level department id?
Wayfair serves a department such as Furniture as a merchandised landing page: a short featured selection with no prices and no result total. Those rows are returned with page_kind set to department_landing and a page_note pointing you at filters on the same id, which returns the child categories to browse for a priced grid. An id that is a navigation page rather than a grid is answered NOT_FOUND with the same guidance instead of an empty list.
What is the Wayfair API?
Wayfair API is a ReefAPI endpoint group for the largest us home-goods retailer: prices, the full spec table, reviews, and every colour and size option priced separately. It returns live JSON through POST requests under /wayfair/v1.
Is the Wayfair API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Wayfair calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Wayfair login or account?
No login to Wayfair is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Wayfair data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Wayfair API use?
Wayfair actions currently cost 1-4 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Wayfair from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call wayfair actions with the same key, credit pool and JSON envelope used by normal REST requests.