Zappos API endpoint
Returns a Zappos brand page's product grid, with real page-based pagination and per-field filter facets. brand accepts a full brand URL copied from zappos.com, the "slug/id.zso" path from that URL, or just the opaque id from a GET /zappos/brands result's own id field. An unrecognized brand returns 404.
/zappos/brandbrand is required. It accepts a full brand URL copied from zappos.com (e.g. https://www.zappos.com/adidas-outdoor/WgLNGeICAQs.zso), the slug/id.zso path from that URL (e.g. adidas-outdoor/WgLNGeICAQs.zso), or just the opaque id from a GET /zappos/brands result's own id field. page is optional, 1-based, defaults to 1.
Notable response behavior:
page_count is the total number of pages for the brand; has_more is true while page < page_count.page beyond page_count returns a normal 200 with an empty products array, not an error.facets lists this page's own filterable fields (gender, department, shoe size, and more), each value carrying a live count and a drill-down url -- see GET /zappos/search's docs for the full shape.on_sale and is_new are booleans. percent_off is a display string (e.g. "26%").brand returns 404.| Field | Filled in, of 50 checked | Values in the sample |
|---|---|---|
| product_id | 50 | |
| style_id | 50 | |
| color_id | 50 | |
| brand_name | 50 | adidas in all 50 |
| product_name | 50 | “Terrex Rockadia Trail Running” and 32 other values |
| product_type | 50 | Shoes in all 50 |
| color | 50 | “Black” and 14 other values |
| style_color | 50 | “Black/Carbon/Black” and 44 other values |
| price | 50 | “$69.00” and 28 other values |
| original_price | 50 | “$70.00” and 18 other values |
| percent_off | 50 | “1%” and 11 other values |
| on_sale | 50 | true in 15 of 50 |
| is_new | 50 | true in 2 of 50 |
| rating | 20 | 1 to 5, median 4 |
| review_count | 20 | 1 to 1,872, median 2 |
| gender | 50 | median 1 entry |
| on_hand | 50 | 2 to 131, median 30 |
| image_url | 50 | m.media-amazon.com |
| url | 50 | zappos.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| brand | string | Yes | Zappos brand URL, slug/id.zso path, or opaque id | adidas-outdoor/WgLNGeICAQs.zso | |
| page | integer | No | 1 | Result page, 1-based, defaults to 1 | 1 |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/zappos/brand?brand=adidas-outdoor%2FWgLNGeICAQs.zso&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"brand": "adidas-outdoor/WgLNGeICAQs.zso",
"brand_id": "WgLNGeICAQs",
"page": 1,
"page_size": 100,
"page_count": 1,
"total_count": 49,
"count": 1,
"has_more": false,
"products": [
{
"product_id": "10046325",
"style_id": "6667005",
"color_id": "1129636",
"brand_name": "adidas",
"product_name": "Terrex Tracefinder Plus Trail Running Shoes",
"product_type": "Shoes",
"color": "Khaki",
"style_color": "Khaki/Wonder Alumina/Aurora Coffee",
"price": "$100.00",
"original_price": "$100.00",
"percent_off": "0%",
"on_sale": false,
"is_new": true,
"gender": [
"Men"
],
"on_hand": 71,
"image_url": "https://m.media-amazon.com/images/I/71YMuToIkdL._SX1000_.jpg",
"url": "https://www.zappos.com/p/adidas-outdoor-terrex-tracefinder-plus-trail-running-shoes-khaki/product/10046325/color/1129636"
}
],
"facets": [
{
"field": "txAttrFacet_Gender",
"name": "Gender",
"multi_select": false,
"values": [
{
"value": "Men",
"count": 38,
"selected": false,
"url": "https://www.zappos.com/adidas-outdoor-men/x.zso"
}
]
}
],
"source_url": "https://www.zappos.com/adidas-outdoor/WgLNGeICAQs.zso?page=0",
"fetched_at": "2026-08-11T10:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/zappos.brandResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | zappos.BrandResponse | No | ||||
| data.brand | string | No | ||||
| data.brand_id | string | No | ||||
| data.count | integer | No | ||||
| data.facets | array | No | ||||
| data.facets[].field | string | No | txAttrFacet_Gender | |||
| data.facets[].multi_select | boolean | No | ||||
| data.facets[].name | string | No | Gender | |||
| data.facets[].values | array | No | ||||
| data.facets[].values[].count | integer | No | 69 | |||
| data.facets[].values[].selected | boolean | No | ||||
| data.facets[].values[].url | string | No | ||||
| data.facets[].values[].value | string | No | Women | |||
| data.fetched_at | string | No | ||||
| data.has_more | boolean | No | ||||
| data.page | integer | No | ||||
| data.page_count | integer | No | ||||
| data.page_size | integer | No | ||||
| data.products | array | No | ||||
| data.products[].brand_name | string | No | ||||
| data.products[].color | string | No | ||||
| data.products[].color_id | string | No | ||||
| data.products[].gender | array | No | ||||
| data.products[].image_url | string | No | ||||
| data.products[].is_new | boolean | No | ||||
| data.products[].on_hand | integer | No | ||||
| data.products[].on_sale | boolean | No | ||||
| data.products[].original_price | string | No | ||||
| data.products[].percent_off | string | No | ||||
| data.products[].price | string | No | ||||
| data.products[].product_id | string | No | ||||
| data.products[].product_name | string | No | ||||
| data.products[].product_type | string | No | ||||
| data.products[].rating | number | No | ||||
| data.products[].review_count | integer | No | ||||
| data.products[].style_color | string | No | ||||
| data.products[].style_id | string | No | ||||
| data.products[].url | string | No | ||||
| data.source_url | string | No | ||||
| data.total_count | integer | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/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/zappos/brand?brand=adidas-outdoor%2FWgLNGeICAQs.zso&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"