wayfair.com APIwayfair.com ↗
Search Wayfair products, retrieve details by SKU or URL, browse daily deals, explore categories, and filter by price and physical dimensions.
curl -X GET 'https://api.parse.bot/scraper/881e95f6-2127-4669-83b7-fca30162d85e/search_products?query=sofa' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on Wayfair with optional pagination. Returns a list of product summaries including SKU, price, rating, and image URL.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword (e.g. 'sofa', 'desk', 'bookshelf') |
{
"type": "object",
"fields": {
"count": "integer total number of products returned on the page",
"products": "array of product summary objects with name, sku, url, price, rating, review_count, image_url"
},
"sample": {
"data": {
"count": 60,
"products": [
{
"sku": "W009142327",
"url": "https://www.wayfair.com/furniture/pdp/wade-logan-azriah-charles-of-london-sofa-w009142327.html?piid=820748985",
"name": null,
"price": "$349.99",
"rating": "4.5",
"image_url": "https://assets.wfcdn.com/im/41702288/resize-h400-w400%5Ecompr-r85/4306/430660677/Azriah+Upholstered+80.31%27%27+Sofa.jpg",
"review_count": "1329"
}
]
},
"status": "success"
}
}About the wayfair.com API
The Wayfair API covers 5 endpoints for querying Wayfair's furniture and home goods catalog. Use search_products to find items by keyword with pagination, get_product_details to retrieve brand, pricing, images, ratings, and specs for a specific SKU or URL, and filter_products_by_dimensions to narrow results by width, height, depth, and price. Response objects include fields such as original_price, review_count, specifications, and currency.
Search and Product Details
The search_products endpoint accepts a query string and an optional page integer for pagination. Each item in the returned products array includes name, sku, url, price, rating, review_count, and image_url. To drill into a specific listing, pass either a sku (e.g. W009142327) or a full url to get_product_details, which returns a richer object: brand, images (array), description, original_price (null when no discount is active), and currency (always USD).
Daily Deals and Category Navigation
get_daily_deals requires no inputs and returns a deals array, each entry carrying name, url, and image_url for current Wayfair sale events. get_categories similarly takes no inputs and returns a categories array of objects with name and url, reflecting Wayfair's homepage navigation structure. These two endpoints are useful for surfacing promotional windows or building a category browser without a search query.
Dimension and Price Filtering
filter_products_by_dimensions runs a keyword search via query, then checks the detail pages of the first 10 results against the supplied depth_max, width_max, height_max, and price_max values (all in inches and USD respectively). Only products whose specifications satisfy every provided maximum are included in filtered_products. This is especially useful for space-constrained purchasing workflows such as fitting furniture into a room with known measurements.
- Build a furniture size-checker that rejects items exceeding a room's width, depth, and height limits using
filter_products_by_dimensions. - Track price drops on specific SKUs by comparing
priceagainstoriginal_priceinget_product_detailsresponses. - Aggregate current Wayfair promotions into a deals digest using
get_daily_dealsname and URL fields. - Power a product search widget that displays thumbnail, rating, and review count from the
search_productsproductsarray. - Generate a navigable category index from
get_categoriesfor a home-goods comparison site. - Monitor rating and
review_counttrends for specific products over time usingget_product_detailswith a fixed SKU. - Match competitor furniture dimensions by querying multiple keywords and filtering results to a target size range.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Wayfair have an official public developer API?+
What does `get_product_details` return that `search_products` does not?+
search_products returns summary fields: name, sku, url, price, rating, review_count, and image_url. get_product_details adds brand, an images array (multiple angles), description, specifications, original_price (null when no sale is active), and currency. Specifications are needed for the dimension-filtering endpoint to function.How does pagination work for product search results?+
page to search_products alongside your query. The response includes a count field showing how many products were returned on that page. There is no total_pages or total_results field in the response, so you increment page until count drops below the per-page maximum to detect the last page.Does the API return customer review text or only aggregate ratings?+
rating (star score out of 5) and review_count (number of reviews). Individual review text, reviewer names, and review dates are not exposed by any endpoint. You can fork this API on Parse and revise it to add a review-listing endpoint if per-review text is required.Does `filter_products_by_dimensions` check all results from a search, or only a subset?+
query match quality. You can fork this API on Parse and revise it to increase the result window or add multi-page sampling.