Wayfair API endpoint
Returns a page of Wayfair categories discovered from Wayfair's own published sitemap, closing the discovery gap where a category id otherwise has to be found elsewhere. Pair a returned id with GET /wayfair/category to browse that category's product grid. name is derived from the category's own URL slug (title-cased), not an authoritative site-provided label. q, if set, case-insensitively filters to categories whose derived name or department contains it.
/wayfair/categoriesq is optional and case-insensitively filters to categories whose derived name or department contains it. page is optional, 1-based, defaults to 1. page_size is optional, defaults to 100, max 1000.
Notable response behavior:
name is derived from the category's own URL slug (title-cased), not an authoritative site-provided label -- Wayfair's sitemap does not publish a display name.department is the top-level storefront section the category sits under (e.g. furniture, appliances).has_next indicates whether a later page has more results.| Field | Filled in, of 40 checked | Values in the sample |
|---|---|---|
| id | 40 | |
| name | 40 | “Kids Shower Curtains” and 39 other values |
| department | 40 | “baby-kids” and 13 other values |
| url | 40 | wayfair.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | No | Case-insensitive substring filter on name or department | chair | |
| page | integer | No | 1 | Result page, 1-based, defaults to 1 | 1 |
| page_size | integer | No | 100 | Results per page, defaults to 100, max 1000 | 100 |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/wayfair/categories?q=coffee&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"total": 1521,
"page": 1,
"page_size": 2,
"has_next": true,
"categories": [
{
"id": "1829184",
"name": "Kids Shower Curtains",
"department": "baby-kids",
"url": "https://www.wayfair.com/baby-kids/sb0/kids-shower-curtains-c1829184.html"
},
{
"id": "1773657",
"name": "Bar Carts",
"department": "furniture",
"url": "https://www.wayfair.com/furniture/sb0/bar-carts-c1773657.html"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/wayfair.categoriesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | wayfair.CategoriesResponse | No | ||||
| data.categories | array | No | ||||
| data.categories[].department | string | No | baby-kids | |||
| data.categories[].id | string | No | 1829184 | |||
| data.categories[].name | string | No | Kids Shower Curtains | |||
| data.categories[].url | string | No | https://www.wayfair.com/baby-kids/sb0/kids-shower-curtains-c1829184.html | |||
| data.has_next | boolean | No | true | |||
| data.page | integer | No | 1 | |||
| data.page_size | integer | No | 100 | |||
| data.total | integer | No | 1521 | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/wayfair/categories?q=coffee&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"