---
title: "Get a Zappos product's full detail"
method: GET
path: "/zappos/product/{productId}"
tags: ["Zappos"]
---

# Get a Zappos product's full detail

`GET /zappos/product/{productId}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/zappos/product/{productId}`
- Auth: API key in header `x-api-key`

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.

## Path parameters

- `productId` string, required

## Query parameters

- `colorId` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ZapposProductDetailResponseDoc
  - `code` integer
  - `data` ZapposProductDetailResponse
    - `arch_fit` ZapposFitFeedback
      - `most_common_answer` string: MostCommonAnswer and MostCommonPercentage are Zappos's own "most common answer" summary for this dimension, e.g. "Felt true to size" at 80%.
      - `most_common_percentage` number
      - `percentages` object: Percentages maps each response option's own text (e.g. "Felt true to size") to the percentage of reviewers who chose it.
    - `brand_name` string
    - `breadcrumbs` string[]: Breadcrumbs is the site's own navigation path to this product (e.g. ["shoes", "sneakers & athletic shoes", "adidas Outdoor"]).
    - `category` string
    - `color` string
    - `color_id` string
    - `color_variants` ZapposColorVariant[]: ColorVariants lists every sibling color variant of this product (including this one), each with its own price. See service.go's doc comment on where this is sourced from.
      - `color_id` string
      - `color_name` string
      - `original_price` string
      - `percent_off` string
      - `price` string
      - `url` string
    - `currency_code` string
    - `description` string
    - `featured_reviews` ZapposFeaturedReview[]: FeaturedReviews holds Zappos's own site-selected featured reviews -- at most two (the page's own "most helpful" and "most voted" picks, deduplicated if they are the same single review) -- each with real author/date/body/rating, not the whole review corpus. See service.go's doc comment for why this differs from the JSON-LD block's own content-free review stub.
      - `author` string
      - `body` string
      - `comfort_rating` number
      - `date` string
      - `id` string
      - `look_rating` integer
      - `overall_rating` integer
      - `up_votes` integer
      - `verified_purchase` boolean
    - `fetched_at` string
    - `images` string[]
    - `in_stock` boolean
    - `original_price` string
    - `price` string
    - `product_id` string
    - `product_name` string
    - `rating` number
    - `rating_breakdown` object: RatingBreakdown maps each star value ("1" through "5") to the percentage of reviewers who gave that rating.
    - `rating_count` integer: RatingCount is the product's total review count, sourced from the page's own aggregate rating summary (not the number of entries in FeaturedReviews, which is at most 2 -- see FeaturedReviews' doc comment).
    - `size_fit` ZapposFitFeedback
      - `most_common_answer` string: MostCommonAnswer and MostCommonPercentage are Zappos's own "most common answer" summary for this dimension, e.g. "Felt true to size" at 80%.
      - `most_common_percentage` number
      - `percentages` object: Percentages maps each response option's own text (e.g. "Felt true to size") to the percentage of reviewers who chose it.
    - `source_url` string
    - `url` string
    - `width_fit` ZapposFitFeedback
      - `most_common_answer` string: MostCommonAnswer and MostCommonPercentage are Zappos's own "most common answer" summary for this dimension, e.g. "Felt true to size" at 80%.
      - `most_common_percentage` number
      - `percentages` object: Percentages maps each response option's own text (e.g. "Felt true to size") to the percentage of reviewers who chose it.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)
