--- title: "Wayfair API: JSON data, 5 endpoints, 1 credit per call" description: "Wayfair API for furniture and home product search, category listings, product details and reviews in the US, Canada and UK as JSON. 1 credit per call." url: https://perceptlayer.com/apis/wayfair --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Wayfair 1 credit per call 5 endpoints 19 datapoints # Wayfair API Wayfair API for furniture and home product search, category listings, product details and reviews in the US, Canada and UK as JSON. 1 credit per call. [Get a free API key](https://perceptlayer.com/signup) Run it below Wayfair GET /v1/wayfair/search?query=sofa ``` { "success": true, "data": { "query": "sofa", "pagination": { "page": 1, "per_page": 48, "total": 262340, "total_pages": 5466, "has_next_page": true }, "sort": "recommended", "category_url": "https://www.wayfair.com/furniture/sb0/sofas-c413892.html", "products": [ { "position": 1, "sku": "W006759421", "variant_id": "BQ04011156", "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", "price": { "amount": 415.99, "currency": "USD" }, "original_price": { "amount": 699.99, "currency": "USD" }, "on_sale": true, "savings_percent": 41, "rating": 4.48, "review_count": 1463, "image_urls": [ "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/4306/430660494/image.jpg", "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/3705/370591211/image.jpg" ], "flag": "Early Black Friday", "is_best_value": true, "delivery": { "promise": "FREE 1-Day Delivery", "estimated_arrival": "Get it Tomorrow" }, "stock_message": "619 Left in Stock", "selected_options": [ { "name": "Upholstery Color", "value": "Chestnut Performance Faux Leather" } ], "sponsored": true }, { "position": 2, "sku": "W008221555", "variant_id": "AG38006862", "title": "Carmencita 65\" Linen Upholstered Square Arm Loveseat", "brand": "Wade Logan®", "url": "https://www.wayfair.com/furniture/pdp/wade-logan-carmencita-65-linen-upholstered-square-arm-loveseat-w008221555.html", "price": { "amount": 319.99, "currency": "USD" }, "original_price": { "amount": 460, "currency": "USD" }, "on_sale": true, "savings_percent": 30, "rating": 4.51, "review_count": 1965, "image_urls": [ "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/2473/247335722/image.jpg", "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/3743/374335315/image.jpg" ], "flag": "Early Black Friday", "is_best_value": true, "delivery": { "promise": "FREE 1-Day Delivery", "estimated_arrival": "Get it Tomorrow" }, "stock_message": "820 Left in Stock", "selected_options": [ { "name": "Upholstery Color", "value": "Gray Linen" }, { "name": "Support", "value": "Solid Wood" } ], "sponsored": true }, { "position": 3, "sku": "W118436057", "variant_id": "QC80853726", "title": "108\" Cloud L-Shaped Modular Sectional Sofa, 2 Washable Cover Sets with Ottoman, Oversized Deep Seat Living Room Couch for DIY Color Switch, Boneless Style (White & Grey)", "brand": "Latitude Run®", "url": "https://www.wayfair.com/furniture/pdp/latitude-run-boneless-108-boneless-cloud-modular-sectional-sofa-with-2-washable-cover-sets-l-shape-deep-seat-couch-with-ottoman-toss-pillows-oversized-comfy-living-room-sofa-diy-color-refresh-white-grey…", "price": { "amount": 869.99, "currency": "USD" }, "original_price": { "amount": 1899.99, "currency": "USD" }, "on_sale": true, "savings_percent": 54, "rating": 4.15, "review_count": 99, "image_urls": [ "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/4955/495561351/image.jpg", "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/4944/494417986/image.jpg" ], "flag": "Buy More, Save More", "is_best_value": false, "delivery": { "promise": "FREE Fast Delivery", "estimated_arrival": "Get it by Mon, Nov 16" }, "stock_message": "136 Left in Stock", "selected_options": [ { "name": "Upholstery Material", "value": "White/Gray" } ], "sponsored": true } ], "filters": [ { "id": "69278", "name": "Sale", "type": "options", "options": [ { "id": "8", "name": "Sale", "selected": false, "enabled": true } ] }, { "id": "1234567890", "name": "Fast Delivery", "type": "options", "options": [ { "id": "2147483646", "name": "Fast Delivery", "selected": false, "enabled": true } ] }, { "id": "160734", "name": "Wayfair Verified", "type": "options", "options": [ { "id": "579585", "name": "Wayfair Verified", "selected": false, "enabled": true } ] } ] }, "meta": { "endpoint_family": "search", "request_id": "req_bcf29e822d57479191b3a2ea2a6544cd", "credits_charged": 1, "credits_remaining": 1944 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | position integer | sku string | variant\_id string | title string | brand string | url url | price object | original\_price object | on\_sale boolean | savings\_percent integer | rating number | review\_count integer | image\_urls string\[\] | flag string | is\_best\_value boolean | delivery object | stock\_message string | selected\_options object\[\] | sponsored boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 1 | W006759421 | BQ04011156 | Barton 80.31'' Faux Leather Square Arm Sofa | Ebern Designs | https://www.wayfair.com/furniture/pdp/ebern-designs-barton-8031-faux-leather-square-arm-sofa-w006759421.html | {2 fields} | {2 fields} | true | 41 | 4.48 | 1463 | \[2 items\] | Early Black Friday | true | {2 fields} | 619 Left in Stock | \[1 item\] | true | | 2 | 2 | W008221555 | AG38006862 | Carmencita 65" Linen Upholstered Square Arm Loveseat | Wade Logan® | https://www.wayfair.com/furniture/pdp/wade-logan-carmencita-65-linen-upholstered-square-arm-loveseat-w008221555.html | {2 fields} | {2 fields} | true | 30 | 4.51 | 1965 | \[2 items\] | Early Black Friday | true | {2 fields} | 820 Left in Stock | \[2 items\] | true | | 3 | 3 | W118436057 | QC80853726 | 108" Cloud L-Shaped Modular Sectional Sofa, 2 Washable Cover Sets with Ottoman, Oversized Deep Seat Living Room Couch for DIY Color Switch, Boneless Style (White & Grey) | Latitude Run® | https://www.wayfair.com/furniture/pdp/latitude-run-boneless-108-boneless-cloud-modular-sectional-sofa-with-2-washable-cover-sets-l-shape-deep-seat-couch-with-ottoman-toss-pillows-oversized-comfy-living-room-sofa-diy-color-refresh-white-grey… | {2 fields} | {2 fields} | true | 54 | 4.15 | 99 | \[2 items\] | Buy More, Save More | false | {2 fields} | 136 Left in Stock | \[1 item\] | true | Recorded from our API · 3 items shown · 19 datapoints per item GET /v1/wayfair/search?query=sofa 19 datapoints ### Identity - sku string - variant\_id string - title string - brand string ### Contact - url url - image\_urls string\[\] ### Reputation - rating number - review\_count integer ### Price - price object - original\_price object ### Other - position integer - on\_sale boolean - savings\_percent integer - flag string - is\_best\_value boolean - delivery object - stock\_message string - selected\_options object\[\] - sponsored boolean Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/wayfair/search?query=sofa" \ -H "X-API-Key: $API_KEY" ``` Wayfair · 5 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/wayfair/autocomplete`](https://perceptlayer.com/apis/wayfair/autocomplete) | `query` +1 optional | 1 credit | | [GET `/v1/wayfair/category`](https://perceptlayer.com/apis/wayfair/category) | none +8 optional | 1 credit | | [GET `/v1/wayfair/product`](https://perceptlayer.com/apis/wayfair/product) | none +4 optional | 1 credit | | [GET `/v1/wayfair/reviews`](https://perceptlayer.com/apis/wayfair/reviews) | `variant_id` +7 optional | 1 credit | | [GET `/v1/wayfair/search`](https://perceptlayer.com/apis/wayfair/search) | `query` +2 optional | 1 credit | Overview ## About the Wayfair API ## What you can get The Wayfair API returns Wayfair product data as JSON through 5 endpoints. Each takes a `domain` of com, ca or co.uk. - **Search:** `search` takes a `query`, with `page`. `autocomplete` takes a partial `query`. - **Categories:** `category` takes a `category_id` or a category `url`, with `page`, `filters`, `price_min`, `price_max` and `sort` (recommended, price\_asc, price\_desc, rating, most\_purchased, biggest\_savings, popularity, total\_price\_asc or total\_price\_desc). - **Products:** `product` takes a `sku` or a product `url`, with `option_ids`. - **Reviews:** `reviews` takes a `variant_id`, with `limit`, `cursor`, `ratings`, `aspects`, `search` and `sort` (RELEVANCE\_DESC, HELPFULNESS\_DESC, RATING\_DESC, RATING\_ASC, DATE\_DESC or PHOTOS\_COUNT\_DESC). The recorded search for "sofa" returns `products`, each with `position`, `sku`, `variant_id`, `title`, `brand`, `url`, `price` and `original_price` (amount and currency), `on_sale`, `savings_percent`, `rating`, `review_count`, `image_urls`, `delivery`, `stock_message`, `selected_options` and `sponsored`. It also returns `pagination` with `total` (262,340 in that recording), `total_pages` and `has_next_page`, the `category_url` the search maps to, and `filters`. ## How a call works Search, then look up: `GET /v1/wayfair/search?query=sofa` with your key in the `X-API-Key` header returns each product's `sku` and `variant_id`; `product` takes the `sku` and `reviews` takes the `variant_id`. To page a category instead, send `GET /v1/wayfair/category?category_id=413892&sort=price_asc`. Check `has_next_page` before asking for the next `page`. Every successful call costs 1 credit; failed calls cost nothing. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) Use cases ### Track Wayfair prices and sale discounts for a product list `Use the Wayfair API to track Wayfair prices and sale discounts for a product list` ### Compare prices across the US, Canada and UK sites with \`domain\` `` Use the Wayfair API to compare prices across the US, Canada and UK sites with `domain` `` ### Rank a category by biggest savings or most purchased `Use the Wayfair API to rank a category by biggest savings or most purchased` ### Watch stock messages and delivery promises for products `Use the Wayfair API to watch stock messages and delivery promises for products` FAQ ## Questions **How much does the Wayfair API cost?** Each successful call costs one credit, and each search or category page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale. **Which Wayfair sites can I query?** Wayfair in the US, Canada and the UK: pass \`domain\` as com, ca or co.uk. **Do I need a Wayfair account?** No. You call this Wayfair API with your Perceptlayer key in the \`X-API-Key\` header, with no Wayfair login. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Should I build a Wayfair scraper instead?** You can, but a Wayfair scraper is code you maintain: page changes break it, requests get blocked, and Wayfair's terms govern how you collect data. The Wayfair API gives you 5 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Wayfair API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)