Skip to content

Wayfair Search API

Scrape Wayfair search results instantly with a simple API call

Last Updated: March 6, 2025

A GET request to our endpoint /api/getter/?platform="wayfair_search" will allow you to scrape search results from Wayfair's search engine in real-time.

Example

Here's how you can scrape search results for "bar stool" on Wayfair with our API:

1
curl 'https://data.unwrangle.com/api/getter/?platform=wayfair_search&search=bar+stool&page=1&api_key=API_KEY'

1
2
3
4
5
import requests

url = 'https://data.unwrangle.com/api/getter/?platform=wayfair_search&search=bar+stool&page=1&api_key=API_KEY'
response = requests.get(url)
print(response.json())

1
2
3
const response = await fetch('https://data.unwrangle.com/api/getter/?platform=wayfair_search&search=bar+stool&page=1&api_key=API_KEY')
const data = await response.json()
console.log(data)

1
2
3
4
5
6
<?php
$url = 'https://data.unwrangle.com/api/getter/?platform=wayfair_search&search=bar+stool&page=1&api_key=API_KEY';
$response = file_get_contents($url);
$data = json_decode($response, true);
print_r($data);
?>

1
2
3
4
5
6
require 'net/http'
require 'uri'

uri = URI.parse('https://data.unwrangle.com/api/getter/?platform=wayfair_search&search=bar+stool&page=1&api_key=API_KEY')
response = Net::HTTP.get(uri)
puts response

Query Parameters

As you can see in the example above, our endpoint needs the following query parameters:

Search Query

search

Required

Parameter defines the search query you want to search. You can use anything a user may use in a regular Wayfair search.

page

Optional

The page number for which you want the results. Default value is 1.

Other Required Parameters

platform

Required

Specifies the scraping engine you wish to invoke. In this case, the value should be wayfair_search.

api_key

Required

Your account's token—which can be obtained by signing up here.

Note

Be sure to replace any whitespace in the search keywords with a plus + sign. So, if you're looking to scrape search results for the keyword "bar stool", please set the value of the query parameter search to "bar+stool".

Results

Each request returns up to 6 results. The response will include the following attributes for each product in the search results:

Attributes Returned Data Type Information Represented
url string URL of product listing
thumbnail string URL of product's thumbnail
name string Name of product listing
brand string Brand of the product
variants array Available color/style options
rating float Average rating of product
total_reviews int No. of ratings received
price float Current price of product
list_price float Original/list price of product
price_per_unit float Price per unit of product
open_box_price float Price for open box items
currency string Currency of product
currency_symbol string Currency symbol of product
features array Product features
is_sponsored boolean Whether product is an ad
wayfair_verified boolean Whether product is verified
current_variant string Currently displayed variant
est_delivery_date string Estimated delivery information
retailer_badge string Special retailer badge info
is_quick_ship boolean Whether product ships quickly

Response Example

Here's the response you can expect to receive for the request showcased above:

{
    "success": true,
    "search_url": "https://www.wayfair.com/keyword.php?keyword=bar+stool",
    "page": 1,
    "total_results": 34076,
    "result_count": 6,
    "results": [
        {
            "url": "https://www.wayfair.com/furniture/pdp/corrigan-studio-vintage-inspired-swivel-bar-stool-with-wood-frame-with-leather-upholstery-w111352220.html",
            "thumbnail": "https://assets.wfcdn.com/im/45497887/resize-h400-w400%5Ecompr-r85/2949/294956069/Vintage-Inspired+Swivel+Bar+Stool+With+Wood+Frame%2C+With+Leather+Upholstery.jpg",
            "name": "Vintage-Inspired Swivel Bar Stool With Wood Frame, With Leather Upholstery",
            "brand": "Corrigan Studio",
            "variants": [
                "Black",
                "Antique White",
                "Yellowish Brown",
                "Gray",
                "White"
            ],
            "rating": 4.7,
            "total_reviews": 31,
            "price": 249.99,
            "list_price": 404.99,
            "price_per_unit": null,
            "open_box_price": null,
            "currency": "USD",
            "currency_symbol": "$",
            "features": [],
            "is_sponsored": true,
            "wayfair_verified": false,
            "current_variant": "4, Black",
            "est_delivery_date": "Get it by Tue, Mar 11",
            "retailer_badge": null,
            "is_quick_ship": true
        },
        {
            "url": "https://www.wayfair.com/furniture/pdp/everly-quinn-swivel-adjustable-height-bar-stool-modern-velvet-barstool-with-barrel-back-kitchen-island-counter-bar-chair-with-golden-base-w100799812.html",
            "thumbnail": "https://assets.wfcdn.com/im/48456637/resize-h400-w400%5Ecompr-r85/3077/307751849/Swivel+Adjustable+Height+Bar+Stool+Modern+Velvet+Barstool+with+Barrel+Back+Kitchen+Island+Counter+Bar+Chair+with+Golden+Base.jpg",
            "name": "Swivel Adjustable Height Bar Stool Modern Velvet Barstool with Barrel Back Kitchen Island Counter Bar Chair with Golden Base",
            "brand": "Everly Quinn",
            "variants": [
                "Gray",
                "Black",
                "Teal Green",
                "White",
                "Pink"
            ],
            "rating": 4.6,
            "total_reviews": 451,
            "price": 227.99,
            "list_price": 304.99,
            "price_per_unit": null,
            "open_box_price": 101.99,
            "currency": "USD",
            "currency_symbol": "$",
            "features": [],
            "is_sponsored": true,
            "wayfair_verified": false,
            "current_variant": "Gray, 2",
            "est_delivery_date": "Get it Tomorrow",
            "retailer_badge": null,
            "is_quick_ship": false
        },
        {
            "url": "https://www.wayfair.com/furniture/pdp/lark-manor-aleksy-swivel-counter-bar-stool-rbsd9425.html",
            "thumbnail": "https://assets.wfcdn.com/im/12130205/resize-h400-w400%5Ecompr-r85/2909/290962644/Aleksy+Swivel+Solid+Wood+Counter+Stool.jpg",
            "name": "Aleksy Swivel Solid Wood Counter Stool",
            "brand": "Lark Manor",
            "variants": [
                "Creamy Gray",
                "Pure White",
                "Saddle Brown",
                "Camel",
                "Black",
                "Blue"
            ],
            "rating": 4.6,
            "total_reviews": 252,
            "price": 369.99,
            "list_price": 525.0,
            "price_per_unit": 185.0,
            "open_box_price": null,
            "currency": "USD",
            "currency_symbol": "$",
            "features": [],
            "is_sponsored": true,
            "wayfair_verified": false,
            "current_variant": "Counter Stool (26.5\" Seat Height), Creamy Gray",
            "est_delivery_date": null,
            "retailer_badge": null,
            "is_quick_ship": false
        },
        {
            "url": "https://www.wayfair.com/furniture/pdp/17-stories-keighley-faux-leather-upholstered-counterbar-stool-svtn3809.html",
            "thumbnail": "https://assets.wfcdn.com/im/25184288/resize-h400-w400%5Ecompr-r85/2599/259908145/Keighley+Faux+Leather+Upholstered+Counter%2FBar+Stool.jpg",
            "name": "Keighley Faux Leather Upholstered Counter/Bar Stool",
            "brand": "17 Stories",
            "variants": [
                "Blue",
                "Tan Leather/Black Frame",
                "Black Leather/Brushed Gold Frame",
                "Black Leather/Black Frame",
                "Gray Leather/Black Frame",
                "White Leather/Brushed Gold Frame"
            ],
            "rating": 4.7,
            "total_reviews": 5095,
            "price": 257.99,
            "list_price": 455.0,
            "price_per_unit": 129.0,
            "open_box_price": null,
            "currency": "USD",
            "currency_symbol": "$",
            "features": [],
            "is_sponsored": true,
            "wayfair_verified": false,
            "current_variant": "Counter Stool (24.25\" Seat Height), Blue",
            "est_delivery_date": "Get it Tomorrow",
            "retailer_badge": null,
            "is_quick_ship": false
        },
        {
            "url": "https://www.wayfair.com/furniture/pdp/corrigan-studio-mahtab-swivel-counter-bar-stool-w110203341.html",
            "thumbnail": "https://assets.wfcdn.com/im/02254123/resize-h400-w400%5Ecompr-r85/2697/269747601/Mahtab+Swivel+Counter+%26+Bar+Stool.jpg",
            "name": "Mahtab Swivel Counter & Bar Stool",
            "brand": "Corrigan Studio",
            "variants": [
                "Beige Faux Leather",
                "Black Faux Leather"
            ],
            "rating": 4.7,
            "total_reviews": 516,
            "price": 224.99,
            "list_price": 429.99,
            "price_per_unit": 112.5,
            "open_box_price": 180.79,
            "currency": "USD",
            "currency_symbol": "$",
            "features": [],
            "is_sponsored": false,
            "wayfair_verified": false,
            "current_variant": "Counter Stool = 25.59\" Seat Height, Beige Faux Leather",
            "est_delivery_date": "Get it Tomorrow",
            "retailer_badge": "Sale",
            "is_quick_ship": false
        },
        {
            "url": "https://www.wayfair.com/furniture/pdp/wade-logan-27-h-counter-height-bar-stools-set-of-2-modern-barrel-counter-stools-with-backrest-and-arms-metal-frames-linen-fabric-upholstered-accent-barstools-for-kitchen-island-w110445696.html",
            "thumbnail": "https://assets.wfcdn.com/im/90353199/resize-h400-w400%5Ecompr-r85/2695/269552135/Bechtold+Upholstered+Counter+Stool.jpg",
            "name": "Bechtold Upholstered Counter Stool",
            "brand": "Wade Logan",
            "variants": [
                "Linen Linen/ Black Frame",
                "Carbon Gray Linen/ Black Frame",
                "Beige Linen/ Gold Frame",
                "Light Gray Linen/ Black Frame",
                "Beige Linen/ Black Frame"
            ],
            "rating": 4.7,
            "total_reviews": 318,
            "price": 279.99,
            "list_price": 319.99,
            "price_per_unit": 140.0,
            "open_box_price": null,
            "currency": "USD",
            "currency_symbol": "$",
            "features": [],
            "is_sponsored": false,
            "wayfair_verified": false,
            "current_variant": "Linen Linen/ Black Frame",
            "est_delivery_date": "Get it by Sat, Mar 8",
            "retailer_badge": "Sale",
            "is_quick_ship": false
        }
    ],
    "remaining_credits": 6003467.0
}

Request Cost

• 10 credits are deducted for each successful request to the Wayfair Search API

Support

If you want to add a parameter to our response, or have any question or feedback, please write to us at support@unwrangle.com