# Zappos Product API Documentation

<p><strong>Zappos Product API Documentation</strong> Get one Zappos product by the id returned from search, or by a public product url. The answer lists every colourway with its style id, color id, name, brand, numeric original and sale price, discount, stock, full-size images and rating. Send style_id for one exact colourway. Ids are accepted unchanged by the reviews endpoint. Rating zero is returned as null. Prices are US dollars. Each request costs 1 credit; a failed request is never billed.</p>

- **Documentation:** [https://scrappa.co/docs/zappos-api/zappos_product](https://scrappa.co/docs/zappos-api/zappos_product)
- **API group:** Zappos API
- **Endpoint:** `GET https://scrappa.co/api/zappos/product`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer | No | Numeric product id from Zappos search, for example 10002909. Required unless url is sent. |
| `url` | string | No | A public zappos.com product url. Alternative to id. |
| `style_id` | integer | No | Optional style id from search to return one exact colourway. |

## Example response

```json
{
    "data": {
        "filter": "productId",
        "currency": "USD",
        "variants": [
            {
                "name": "Men's Running Shoe",
                "brand": "Nike",
                "image": "https://m.media-amazon.com/images/I/example._AC_SR768,1024_.jpg",
                "price": {
                    "amount": 124.95,
                    "on_sale": true,
                    "currency": "USD",
                    "sale_amount": 124.95,
                    "original_amount": 154.95,
                    "discount_percent": 19
                },
                "rating": {
                    "count": 212,
                    "average": 4.5
                },
                "color_id": "10002909",
                "style_id": "6549810",
                "product_id": "10002909",
                "style_color": "Black",
                "availability": {
                    "on_hand": 14,
                    "in_stock": true
                }
            }
        ],
        "product_id": "10002909",
        "total_variants": 11
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "duration_ms": 432,
        "endpoint_family": "product"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The id is missing or invalid. Zappos is not called and the request is not billable. |
| 404 | Not Found | Zappos has no product with this id. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
