Skip to content
Scrappa Get API key
Wayfair API 1 credit/request

Wayfair Product API Documentation

GET https://scrappa.co/api/wayfair/product

Wayfair Product API returns one product by SKU or product URL: title, brand, breadcrumbs, price with sale price and savings, options (size, finish) with stock per value, delivery estimate, specifications, dimensions, feature bullets, description, images, video, manuals, the rating with a star histogram, review aspects, the AI review summary and the first page of reviews with a cursor. The variant_id in the answer feeds the reviews route. Pass option_ids from the options of an earlier answer to read another combination.

Credits: 1 credit per successful request, also when a product request is served by the fallback route. Failed requests are not billed.

Location: delivery dates, and in some cases stock, follow the location of the request, not the location of the caller. SKU format: W followed by digits on wayfair.com, C followed by digits on wayfair.ca. A SKU of one storefront is not found on another.

Wayfair Product API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/wayfair/product
Auth header
x-api-key
Cost
1 credit/request
Response preview
200 OK
{
    "data": {
        "sku": "W100254325",
        "url": "https://www.wayfair.com/storage-organization/pdp/haotian-shoe-storage-cabinet-for-entryway-with-pull-down-drawers-w100254325.html",
        "brand": {
            "id": null,
            "url": "https://www.wayfair.com/brand/bnd/haotian-b61603.html",
            "name": "Haotian"
        },
        "price": {
            "amount": 116.99,
            "currency": "USD"
        },
        "title": "Shoe Cabinet Tall Narrow Entryway 3 Drawers Flip-Down Shoe Storage Organizer for Small Space,White,19.7\"W x 7.5\"D x 50.8\"H",
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

4 optional filters available.

sku string Optional

Wayfair SKU of the chosen storefront, for example W100254325. Send sku or url.

Example value example
url string Optional
Open example

Full product page URL of the chosen storefront. Send url or sku.

Example value https://example.com/product
option_ids string Optional

Option ids from the options of a product answer, comma separated, to select that combination.

Example value example
domain string Optional

Storefront: com (default), ca or co.uk. SKUs, slugs and category ids differ per storefront: use ids from the same storefront.

Example value example.com

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "sku": "W100254325",
        "url": "https://www.wayfair.com/storage-organization/pdp/haotian-shoe-storage-cabinet-for-entryway-with-pull-down-drawers-w100254325.html",
        "brand": {
            "id": null,
            "url": "https://www.wayfair.com/brand/bnd/haotian-b61603.html",
            "name": "Haotian"
        },
        "price": {
            "amount": 116.99,
            "currency": "USD"
        },
        "title": "Shoe Cabinet Tall Narrow Entryway 3 Drawers Flip-Down Shoe Storage Organizer for Small Space,White,19.7\"W x 7.5\"D x 50.8\"H",
        "domain": "com",
        "images": [
            {
                "id": 384580079,
                "alt": null,
                "url": "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/3845/384580079/image.jpg",
                "type": "environmental"
            },
            {
                "id": 255745536,
                "alt": null,
                "url": "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/2557/255745536/image.jpg",
                "type": "non_photo"
            }
        ],
        "rating": {
            "count": 70,
            "average": 4.22,
            "histogram": {
                "1": 4,
                "2": 4,
                "3": 5,
                "4": 17,
                "5": 40
            }
        },
        "videos": [
            {
                "id": 550753,
                "url": "https://secure.img1-fg.wfcdn.com/dm/video/676638a3-d11a-1339-5e0a-f2574674bb9e/554375.mp4",
                "poster_url": "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/4234/423499524/image.jpg",
                "duration_seconds": 17
            }
        ],
        "aspects": [
            {
                "id": "Assembly",
                "name": "Assembly",
                "count": 25,
                "sentiment": "MIXED"
            },
            {
                "id": "Size",
                "name": "Size",
                "count": 21,
                "sentiment": "POSITIVE"
            }
        ],
        "on_sale": true,
        "options": [
            {
                "id": 1,
                "name": "Size",
                "values": [
                    {
                        "id": "51085769",
                        "name": "35.4\" H x 19.7\" W x 7.5\" D",
                        "selected": false,
                        "available": true,
                        "image_url": "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/2551/255126375/image.jpg",
                        "availability": "in_stock"
                    },
                    {
                        "id": "51085770",
                        "name": "50.8\" H x 19.7\" W x 7.5\" D",
                        "selected": true,
                        "available": true,
                        "image_url": "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/2551/255126445/image.jpg",
                        "availability": "in_stock"
                    }
                ],
                "display_type": "text"
            },
            {
                "id": 3,
                "name": "Finish",
                "values": [
                    {
                        "id": "58925223",
                        "name": "Black",
                        "selected": false,
                        "available": true,
                        "image_url": "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/4504/450454391/image.jpg",
                        "availability": "in_stock"
                    },
                    {
                        "id": "58925221",
                        "name": "White",
                        "selected": true,
                        "available": true,
                        "image_url": "https://assets.wfcdn.com/im/00000000/resize-h800-w800%5Ecompr-r85/2551/255126445/image.jpg",
                        "availability": "in_stock"
                    }
                ],
                "display_type": "visual"
            }
        ],
        "reviews": {
            "items": [
                {
                    "id": "167409854",
                    "body": "Wayfair did their part. Purchasing and fulfillment was efficient and flawless. The product itself is another story. I didn\u2019t expect too much...",
                    "date": "06/04/2026",
                    "badge": "Verified Purchase",
                    "author": "Jimmy",
                    "images": [],
                    "locale": "en",
                    "rating": 2,
                    "date_iso": "2026-06-04",
                    "location": "San Bruno, CA",
                    "is_translated": false,
                    "badge_description": "This reviewer purchased this item from Wayfair.",
                    "purchased_options": [
                        {
                            "name": "Finish",
                            "value": "White"
                        },
                        {
                            "name": "Size",
                            "value": "50.8\" H x 19.7\" W x 7.5\" D"
                        }
                    ]
                }
            ],
            "pagination": {
                "next_cursor": "WzEuMCwxLDAuOTg3NSwxNzg3Nzc4MzkyMDAwLDE4MTE3MjMzNV0=",
                "has_next_page": true
            }
        },
        "currency": "USD",
        "delivery": {
            "method": "Ground Delivery",
            "promise": "FREE Fast Delivery",
            "guarantee": "SPEED_GUARANTEE",
            "description": "Get it by Thu, Nov 5",
            "latest_date": "2026-11-05",
            "earliest_date": "2026-11-05"
        },
        "features": [
            {
                "text": "Tired of tripping over shoes? This shoe cabinet features flip-down drawers that open with a gentle p...",
                "title": "Flip-Drawer Shoe Cabinet \u2013 No More Messy Entryway"
            }
        ],
        "documents": [
            {
                "url": "https://www.wayfair.com/dm/document/4d30d73d-80ce-4471-b29f-d148c191a59c/fsr151-w.pdf",
                "type": "installation_and_assembly",
                "format": "pdf"
            }
        ],
        "dimensions": [
            {
                "name": "Overall Dimensions",
                "value": "50.8'' H X 19.7'' W X 7.5'' D"
            },
            {
                "name": "Overall Product Weight",
                "value": "37.8 lb."
            }
        ],
        "variant_id": "BA49044472",
        "breadcrumbs": [
            {
                "id": 215875,
                "url": "https://www.wayfair.com/storage-organization/cat/storage-organization-c215875.html",
                "name": "Storage & Organization"
            },
            {
                "id": 1869009,
                "url": "https://www.wayfair.com/storage-organization/cat/shoe-storage-c1869009.html",
                "name": "Shoe Storage"
            }
        ],
        "description": "Say goodbye to cluttered entryways with our versatile shoe cabinet collection. Available in Plain Pattern (smooth flat front) or Wave Pattern (textured curved f...",
        "part_number": "FSR151-H-W",
        "availability": "in_stock",
        "display_price": "$116.99",
        "savings_label": "47% Off",
        "original_price": {
            "amount": 219.99,
            "currency": "USD"
        },
        "specifications": {
            "details": [
                {
                    "name": "Product Type",
                    "value": "Flip Down Shoe Storage"
                },
                {
                    "name": "Material",
                    "value": "Manufactured Wood"
                }
            ],
            "assembly": [
                {
                    "name": "Mounting / Installation",
                    "value": "Freestanding, Mounting / Installation Required"
                },
                {
                    "name": "Assembly",
                    "value": "Full Assembly Needed"
                }
            ],
            "warranty": [
                {
                    "name": "Commercial Warranty",
                    "value": "No"
                },
                {
                    "name": "Warranty",
                    "value": "Limited Warranty"
                }
            ],
            "certifications": []
        },
        "ai_review_summary": {
            "text": "Customers generally find the product to be a good value, with many praising its size and quality for the price. The compact dimensions are ideal for small spaces, and the product is described as sturdy and well-made. However, opinions on assembly are mixed, with some finding it easy and others experiencing difficulties due to unclear instructions or numerous parts. Capacity is also a point of contention, with some reviewers feeling it holds fewer shoes than advertised.",
            "disclaimer": "AI-generated from customer reviews",
            "highlights": [
                {
                    "text": "compact size",
                    "aspect": "Size",
                    "sentiment": "POSITIVE"
                },
                {
                    "text": "well-made build",
                    "aspect": "Quality",
                    "sentiment": "POSITIVE"
                }
            ]
        },
        "minimum_order_quantity": 1,
        "proposition_65_warning": null
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "product"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A parameter is missing or invalid, or an id does not belong to the request. This response is not billable.

{
    "errors": {
        "domain": [
            "The domain must be com, ca or co.uk."
        ]
    },
    "message": "The request validation failed"
}
404

Not Found

The product or reviews were not found on this storefront. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "product"
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "The requested resource was not found."
    },
    "success": false
}
503

Upstream Unavailable

Wayfair could not be reached, blocked the request or returned data that does not match the request (another page, another sort, a partly loaded grid). This response is not billable and is retryable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "product"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "Wayfair could not be reached. Please retry shortly."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.