# Wayfair Product API Documentation

<p><strong>Wayfair Product API</strong> 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 <strong>AI review summary</strong> and the first page of reviews with a cursor. The <code>variant_id</code> in the answer feeds the reviews route. Pass <code>option_ids</code> from the options of an earlier answer to read another combination.</p><p><strong>Credits:</strong> 1 credit per successful request, also when a product request is served by the fallback route. Failed requests are not billed.</p><p><strong>Location:</strong> delivery dates, and in some cases stock, follow the location of the request, not the location of the caller. <strong>SKU format:</strong> W followed by digits on wayfair.com, C followed by digits on wayfair.ca. A SKU of one storefront is not found on another.</p>

- **Documentation:** [https://scrappa.co/docs/wayfair-api/wayfair_product](https://scrappa.co/docs/wayfair-api/wayfair_product)
- **API group:** Wayfair API
- **Endpoint:** `GET https://scrappa.co/api/wayfair/product`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `sku` | string | No | Wayfair SKU of the chosen storefront, for example W100254325. Send sku or url. |
| `url` | string | No | Full product page URL of the chosen storefront. Send url or sku. |
| `option_ids` | string | No | Option ids from the options of a product answer, comma separated, to select that combination. |
| `domain` | string | No | Storefront: com (default), ca or co.uk. SKUs, slugs and category ids differ per storefront: use ids from the same storefront. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid, or an id does not belong to the request. This response is not billable. |
| 404 | Not Found | The product or reviews were not found on this storefront. This response is not billable. |
| 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. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
