Skip to content

Wayfair Category Search API

Scrape Wayfair's category pages instantly with a simple API call

Last Updated: March 6, 2025

A GET request to our endpoint /api/getter/?platform="wayfair_category" will allow you to scrape category pages from Wayfair in real-time.

Example

Here's how you can scrape Wayfair's category page for King Mattresses with our API:

1
curl 'https://data.unwrangle.com/api/getter/?url=https%3A%2F%2Fwww.wayfair.com%2Fbed-bath%2Fsb0%2Fking-mattresses-c544518.html&page=1&platform=wayfair_category&api_key=API_KEY'

1
2
3
4
5
import requests

url = 'https://data.unwrangle.com/api/getter/?url=https%3A%2F%2Fwww.wayfair.com%2Fbed-bath%2Fsb0%2Fking-mattresses-c544518.html&page=1&platform=wayfair_category&api_key=API_KEY'
response = requests.get(url)
print(response.json())

1
2
3
const response = await fetch('https://data.unwrangle.com/api/getter/?url=https%3A%2F%2Fwww.wayfair.com%2Fbed-bath%2Fsb0%2Fking-mattresses-c544518.html&page=1&platform=wayfair_category&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/?url=https%3A%2F%2Fwww.wayfair.com%2Fbed-bath%2Fsb0%2Fking-mattresses-c544518.html&page=1&platform=wayfair_category&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/?url=https%3A%2F%2Fwww.wayfair.com%2Fbed-bath%2Fsb0%2Fking-mattresses-c544518.html&page=1&platform=wayfair_category&api_key=API_KEY')
response = Net::HTTP.get(uri)
puts response

Note

Any Wayfair category URL with pagination at the bottom can be used to scrape the category. The URL should be encoded before passing it as a query parameter. You can add any filters and then copy the URL. The Wayfair Category Search API works with any category URL that has pagination at the bottom.

Query Parameters

Our endpoint requires the following query parameters:

Query Parameters

url

Required

The encoded URL of the Wayfair category page you wish to scrape. Remember that it must have a list of products and pagination at the bottom to get a successful response.

page

Optional

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

Page parameter overridden

If the URL you pass has a page parameter, it will be overridden by the page parameter in the query, including the default value of 1.

Required Parameters

platform

Required

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

api_key

Required

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

Results

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

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 Number of ratings received
price float Current price of product
list_price float Original/list price of product
price_per_unit float Price per unit if applicable
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,
    "category_url": "https://www.wayfair.com/bed-bath/sb0/king-mattresses-c544518.html?pid=CJ2WX1R4VDI&refid=CJH56Z60P-CJSLF9EWL",
    "page": 1,
    "total_results": 2650,
    "result_count": 6,
    "results": [
        {
            "url": "https://www.wayfair.com/bed-bath/pdp/wayfair-sleep-14-medium-hybrid-mattress-w003131804.html",
            "thumbnail": "https://assets.wfcdn.com/im/79119289/resize-h400-w400%5Ecompr-r85/2818/281875724/Wayfair+Sleep+14%22+Medium+Hybrid+Mattress.jpg",
            "name": "Wayfair Sleep 14\" Medium Hybrid Mattress",
            "brand": "Wayfair Sleep",
            "variants": [],
            "rating": 4.6,
            "total_reviews": 8441,
            "price": 509.99,
            "list_price": 999.0,
            "price_per_unit": null,
            "open_box_price": null,
            "currency": "USD",
            "currency_symbol": "$",
            "features": [
                {
                    "name": "Comfort Level",
                    "value": "Medium"
                },
                {
                    "name": "Product Type",
                    "value": "Hybrid"
                },
                {
                    "name": "Mattress Thickness - Top to Bottom",
                    "value": "14''"
                }
            ],
            "is_sponsored": true,
            "wayfair_verified": false,
            "current_variant": "King",
            "est_delivery_date": null,
            "retailer_badge": null,
            "is_quick_ship": false
        },
        {
            "url": "https://www.wayfair.com/bed-bath/pdp/sealy-to-go-12-medium-hybrid-mattress-in-a-box-scm1379.html",
            "thumbnail": "https://assets.wfcdn.com/im/95419288/resize-h400-w400%5Ecompr-r85/2717/271706242/Sealy+To+Go+12%22+Medium+Hybrid+Mattress+In+a+Box.jpg",
            "name": "Sealy To Go 12\" Medium Hybrid Mattress In a Box",
            "brand": "Sealy",
            "variants": [],
            "rating": 4.5,
            "total_reviews": 620,
            "price": 549.99,
            "list_price": 1299.0,
            "price_per_unit": null,
            "open_box_price": null,
            "currency": "USD",
            "currency_symbol": "$",
            "features": [
                {
                    "name": "Comfort Level",
                    "value": "Medium"
                },
                {
                    "name": "Product Type",
                    "value": "Hybrid"
                },
                {
                    "name": "Mattress Thickness - Top to Bottom",
                    "value": "12''"
                }
            ],
            "is_sponsored": true,
            "wayfair_verified": false,
            "current_variant": "King",
            "est_delivery_date": "Get it by Sat, Mar 8",
            "retailer_badge": null,
            "is_quick_ship": false
        },
        {
            "url": "https://www.wayfair.com/bed-bath/pdp/wayfair-sleep-14-firm-hybrid-mattress-wfsl1039.html",
            "thumbnail": "https://assets.wfcdn.com/im/43896933/resize-h400-w400%5Ecompr-r85/2818/281877010/Wayfair+Sleep+14%22+Firm+Hybrid+Mattress.jpg",
            "name": "Wayfair Sleep 14\" Firm Hybrid Mattress",
            "brand": "Wayfair Sleep",
            "variants": [],
            "rating": 4.5,
            "total_reviews": 4707,
            "price": 399.99,
            "list_price": 759.0,
            "price_per_unit": null,
            "open_box_price": null,
            "currency": "USD",
            "currency_symbol": "$",
            "features": [
                {
                    "name": "Comfort Level",
                    "value": "Firm"
                },
                {
                    "name": "Product Type",
                    "value": "Latex"
                },
                {
                    "name": "Mattress Thickness - Top to Bottom",
                    "value": "14''"
                }
            ],
            "is_sponsored": true,
            "wayfair_verified": false,
            "current_variant": "Gray Waves, Queen",
            "est_delivery_date": "Get it by Tue, Mar 11",
            "retailer_badge": "Deal of the Day",
            "is_quick_ship": true
        },
        {
            "url": "https://www.wayfair.com/bed-bath/pdp/sealy-to-go-10-medium-hybrid-mattress-in-a-box-scm1368.html",
            "thumbnail": "https://assets.wfcdn.com/im/46172905/resize-h400-w400%5Ecompr-r85/1145/114554187/Sealy+to+Go+10%E2%80%9D+Medium+Hybrid+Mattress+in+a+Box.jpg",
            "name": "Sealy to Go 10\" Medium Hybrid Mattress in a Box",
            "brand": "Sealy",
            "variants": [],
            "rating": 4.4,
            "total_reviews": 244,
            "price": 489.99,
            "list_price": 1059.2,
            "price_per_unit": null,
            "open_box_price": null,
            "currency": "USD",
            "currency_symbol": "$",
            "features": [
                {
                    "name": "Comfort Level",
                    "value": "Medium"
                },
                {
                    "name": "Product Type",
                    "value": "Hybrid"
                },
                {
                    "name": "Mattress Thickness - Top to Bottom",
                    "value": "10''"
                }
            ],
            "is_sponsored": true,
            "wayfair_verified": false,
            "current_variant": "King",
            "est_delivery_date": "Get it by Sat, Mar 8",
            "retailer_badge": null,
            "is_quick_ship": false
        },
        {
            "url": "https://www.wayfair.com/bed-bath/pdp/sealy-cool-12-medium-memory-foam-mattress-with-copperchill-technology-scm10018.html",
            "thumbnail": "https://assets.wfcdn.com/im/52954716/resize-h400-w400%5Ecompr-r85/2429/242903362/Sealy+Cool+12%22+Medium+Memory+Foam+Mattress+with+CopperChill+Technology.jpg",
            "name": "Sealy Cool 12\" Medium Memory Foam Mattress with CopperChill Technology",
            "brand": "Sealy",
            "variants": [],
            "rating": 4.7,
            "total_reviews": 7525,
            "price": 475.99,
            "list_price": 1299.0,
            "price_per_unit": null,
            "open_box_price": null,
            "currency": "USD",
            "currency_symbol": "$",
            "features": [
                {
                    "name": "Comfort Level",
                    "value": "Soft-Medium"
                },
                {
                    "name": "Product Type",
                    "value": "Memory Foam"
                },
                {
                    "name": "Mattress Thickness - Top to Bottom",
                    "value": "12''"
                }
            ],
            "is_sponsored": false,
            "wayfair_verified": false,
            "current_variant": "King",
            "est_delivery_date": "Get it Tomorrow",
            "retailer_badge": null,
            "is_quick_ship": false
        },
        {
            "url": "https://www.wayfair.com/bed-bath/pdp/alwyn-home-12-medium-gel-memory-hybrid-mattress-in-a-box-w110475671.html",
            "thumbnail": "https://assets.wfcdn.com/im/45309007/resize-h400-w400%5Ecompr-r85/2761/276148947/12%27%27+Medium+Gel+Memory+Hybrid+Mattress+in+a+Box.jpg",
            "name": "12'' Medium Gel Memory Hybrid Mattress in a Box",
            "brand": "Alwyn Home",
            "variants": [],
            "rating": 4.6,
            "total_reviews": 1012,
            "price": 329.99,
            "list_price": 419.99,
            "price_per_unit": null,
            "open_box_price": null,
            "currency": "USD",
            "currency_symbol": "$",
            "features": [
                {
                    "name": "Comfort Level",
                    "value": "Medium"
                },
                {
                    "name": "Product Type",
                    "value": "Hybrid"
                },
                {
                    "name": "Mattress Thickness - Top to Bottom",
                    "value": "12''"
                }
            ],
            "is_sponsored": false,
            "wayfair_verified": false,
            "current_variant": "King",
            "est_delivery_date": "Get it by Tue, Mar 11",
            "retailer_badge": null,
            "is_quick_ship": true
        }
    ],
    "remaining_credits": 6003422.0
}

Request Cost

• 10 credits are deducted for each successful request to the Wayfair Category 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