Zappos API endpoint
Searches Zappos's product catalog by keyword, with real page-based pagination. Returns products with brand, pricing, sale status, rating, and review count, plus filterable facets (gender, department, shoe size, and more) each with a live result count and its own drill-down URL. Requesting a page beyond the available results returns a normal, empty result rather than an error.
/zappos/searchterm is required, 1 to 200 characters. page is optional, 1-based, defaults to 1.
Notable response behavior:
page_size). page_count is the total number of pages for the term; has_more is true while page < page_count.page beyond page_count returns a normal 200 with an empty products array, not an error.on_sale and is_new are booleans. percent_off is a display string (e.g. "26%").color_id identifies the specific color variant shown in this search result; pass it as colorId to /zappos/product/{productId} to view that exact variant.facets lists this page's own filterable fields. Each facet's field and name describe what it filters (e.g. gender, department, shoe size); each of its values carries a value, a live count for that filter, whether it is currently selected, and a drill-down url. A field with no usable values is omitted.| Field | Filled in, of 100 checked | Values in the sample |
|---|---|---|
| product_id | 100 | |
| style_id | 100 | |
| color_id | 100 | |
| brand_name | 100 | “ASICS” and 17 other values |
| product_name | 100 | “GEL-Kayano® 33 Lite-Show” and 81 other values |
| product_type | 100 | Shoes in all 100 |
| color | 100 | “Navy” and 20 other values |
| style_color | 100 | “Lite Show/Orange Glow” and 84 other values |
| price | 100 | “$180.00” and 61 other values |
| original_price | 100 | “$180.00” and 43 other values |
| percent_off | 100 | “0%” and 19 other values |
| on_sale | 100 | true in 37 of 100 |
| is_new | 100 | true in 8 of 100 |
| gender | 100 | median 1 entry |
| on_hand | 100 | 1 to 9,144, median 51 |
| image_url | 100 | m.media-amazon.com |
| url | 100 | zappos.com |
| rating | 57 | 2 to 5, median 4 |
| review_count | 57 | 1 to 3,064, median 15 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| term | string | Yes | Search keyword | running shoes | |
| 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/search?term=running+shoes&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"term": "running shoes",
"page": 1,
"page_size": 100,
"page_count": 22,
"total_count": 2143,
"count": 2,
"has_more": true,
"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"
},
{
"product_id": "9984297",
"style_id": "1146810",
"color_id": "1112488",
"brand_name": "HOKA",
"product_name": "Clifton 10",
"product_type": "Shoes",
"color": "Vanilla/Birch",
"style_color": "Vanilla/Birch",
"price": "$114.99",
"original_price": "$155.00",
"percent_off": "26%",
"on_sale": true,
"is_new": false,
"rating": 4,
"review_count": 1546,
"gender": [
"Women"
],
"on_hand": 140,
"image_url": "https://m.media-amazon.com/images/I/71zzmruQmAL._SX1000_.jpg",
"url": "https://www.zappos.com/p/hoka-clifton-10-vanilla-birch/product/9984297/color/1112488"
}
],
"facets": [
{
"field": "txAttrFacet_Gender",
"name": "Gender",
"multi_select": false,
"values": [
{
"value": "Women",
"count": 1200,
"selected": false,
"url": "https://www.zappos.com/running-shoes-women/x.zso"
},
{
"value": "Men",
"count": 943,
"selected": false,
"url": "https://www.zappos.com/running-shoes-men/x.zso"
}
]
}
],
"source_url": "https://www.zappos.com/search?page=1&term=running+shoes",
"fetched_at": "2026-08-10T10:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/zappos.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | zappos.SearchResponse | No | ||||
| data.count | integer | No | ||||
| data.facets | array | No | Facets lists this page's own filterable fields (gender, department, shoe size, etc.), each with live result counts and drill-down URLs -- sourced from the same response this package already fetches, not a separate upstream call. See buildFacets's doc comment. Facet record, 8 fields: field, multi_select, name, values. Described under Browse a Zappos brand API. | |||
| 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 | ProductSummary record, 19 fields: brand_name, color, color_id, gender, image_url, is_new, on_hand, on_sale, original_price, percent_off, price, product_id and 7 more. Described under Browse a Zappos brand API. | |||
| data.source_url | string | No | ||||
| data.term | string | No | ||||
| data.total_count | integer | No | ||||
| 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/zappos/search?term=running+shoes&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"