Get a Zappos product's full detail API

Endpoint facts

Method

GET

API path

/zappos/product/{productId}

Auth

apiKey

Credits

1 credit/request

Platform

Zappos

Response schema

#/definitions/zappos.productDetailResponseDoc

Overview

Returns one Zappos product's full detail: name, brand, description, category, breadcrumbs, pricing, images, aggregate rating with a 1-5 star breakdown, up to two featured customer reviews with real author/date/body/rating, reviewer-submitted fit feedback for size/width/arch (each response option's own share of respondents plus the most common answer), and every sibling color variant with its own price. productId is taken from a search result's product_id field or a product page's URL. colorId is optional and selects a specific color variant; an omitted or invalid colorId still resolves the base product using a real color variant rather than failing. An unrecognized productId returns 404. Developers commonly use this endpoint for data enrichment, monitoring, research dashboards, internal automation, and agent-native workflows that need repeatable structured public web data. Authentication uses the documented Crawlora headers, and usage is metered with the credit cost shown on this page.

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost

1 credit/request

Charged response

Successful 2xx responses

Infrastructure behavior

This endpoint is executed through Crawlora's managed scraping infrastructure.

• Proxy strategy: managed automatically where needed
• Browser rendering: enabled for supported targets that require rendered HTML or JavaScript execution
• Browser cluster: supported dynamic workloads can be routed through distributed browser instances
• Retry behavior: automatic retry/fallback may be used depending on endpoint type
• Challenge handling: challenged pages or unusable upstream HTML are detected and surfaced clearly when they cannot be used
• Billing: credits are charged only for successful 2xx responses
• Observability: responses include request context where available

Response behavior

- `breadcrumbs` is the site's own navigation path to the product (e.g. `["shoes", "sneakers & athletic shoes", "HOKA"]`). - `rating`/`rating_count` are the product's aggregate rating and total review count. `rating_breakdown` maps each star value `"1"` through `"5"` to the percentage of reviewers who gave that rating. - `featured_reviews` holds Zappos's own site-selected featured reviews -- at most two (the page's "most helpful" and "most voted" picks) -- each with a real author byline, a date, the actual review text, and multiple rating dimensions. A product with no reviews yet returns an empty list, not an error. - `size_fit`, `width_fit`, and `arch_fit` summarize reviewer-submitted fit feedback for each dimension: `percentages` maps each response option's own text (e.g. `"Felt true to size"`) to the percentage of reviewers who chose it, and `most_common_answer`/`most_common_percentage` are the site's own "most common answer" summary. Absent when the product has no fit-feedback data for that dimension. - `color_variants` lists every sibling color of this product, including the one requested, each with its own price and a direct `url` to that color's own detail page. - `original_price` equals `price` when the product is not on sale. - An unrecognized `productId` returns `404`. A malformed `productId` or `colorId` returns `400` before any upstream request is made. Example response: ```json {"code":200,"msg":"OK","data":{"product_id":"9984297","color_id":"1112488","brand_name":"HOKA","product_name":"Clifton 10","description":"A trusted trainer for daily maintenance miles, the Hoka One One® Clifton 10 delivers a revitalized underfoot experience.","category":"sneakers & athletic shoes","breadcrumbs":["shoes","sneakers & athletic shoes","HOKA"],"color":"Vanilla/Birch","currency_code":"USD","price":"114.99","original_price":"155.00","in_stock":true,"images":["https://m.media-amazon.com/images/I/71zzmruQmAL._SX700_.jpg","https://m.media-amazon.com/images/I/71Et3HTxBXL._SX700_.jpg"],"rating":4,"rating_count":1546,"rating_breakdown":{"1":5,"2":3,"3":7,"4":10,"5":76},"featured_reviews":[{"id":"18383268","author":"Lori, Zappos Customer","date":"May 8, 2025 3:21:47 PM","body":"I have been getting a size 9 in the Hoka Cliftons since the Clifton 6. This time my toe comes all the way to the end of the shoe and the toe box is smaller.","overall_rating":1,"comfort_rating":1,"look_rating":1,"verified_purchase":false,"up_votes":152},{"id":"18360853","author":"Anonymous, Zappos Customer","date":"Apr 24, 2025 5:12:45 AM","body":"This shoe runs smaller than my previous Cliftons. They are much more narrow and that is sad.","overall_rating":3,"comfort_rating":3,"look_rating":3,"verified_purchase":false,"up_votes":67}],"size_fit":{"percentages":{"Felt true to size":80.40435,"Felt a half size smaller than marked":4.0435457},"most_common_answer":"Felt true to size","most_common_percentage":80},"width_fit":{"percentages":{"Felt true to width":86.08,"Felt wider than marked":4.96},"most_common_answer":"Felt true to width","most_common_percentage":86},"color_variants":[{"color_id":"151","color_name":"Black/White","price":"$99.83","original_price":"$155.00","percent_off":"36%","url":"https://www.zappos.com/product/9984297/color/151"},{"color_id":"1112488","color_name":"Vanilla/Birch","price":"$114.99","original_price":"$155.00","percent_off":"26%","url":"https://www.zappos.com/product/9984297/color/1112488"}],"url":"https://www.zappos.com/p/womens-hoka-clifton-10/product/9984297","source_url":"https://www.zappos.com/product/9984297/color/1112488","fetched_at":"2026-08-10T10:00:00Z"}} ```

Error behavior

Crawlora does not silently return bad data when the upstream page cannot be used.

When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.

Related