# Zappos Reviews API Documentation

<p><strong>Zappos Reviews API Documentation</strong> Get public reviews for a Zappos product id from search. Each row carries its id, overall rating, comfort and look ratings, title and text, ISO 8601 date, author, location, shoe size, width and arch, helpful votes and a media flag. Sort by newest or helpful and page with a 1-based page. Each request costs 1 credit when reviews are returned; a failed request is never billed.</p>

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

## 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 | Yes | Numeric product id from Zappos search, for example 10002909. Required. |
| `page` | integer | No | 1-based page, default 1. |
| `sort` | string | No | newest or helpful. |

## Example response

```json
{
    "data": {
        "reviews": [
            {
                "id": "rev-1",
                "text": "Comfortable and true to size.",
                "title": "Great fit",
                "author": "Runner",
                "rating": 5,
                "location": "Austin, TX",
                "has_media": false,
                "shoe_arch": "Neutral",
                "shoe_size": "10",
                "shoe_width": "Medium",
                "look_rating": 4,
                "review_date": "2026-01-15T12:00:00Z",
                "helpful_votes": 12,
                "comfort_rating": 5,
                "verified_purchase": true
            }
        ],
        "sort_by": "newest",
        "pagination": {
            "per_page": 25,
            "current_page": 1,
            "has_next_page": true,
            "total_results": 991
        },
        "product_id": "10002909"
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "duration_ms": 456,
        "endpoint_family": "reviews"
    },
    "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. |
| 503 | Upstream Unavailable | Zappos did not answer. Retry later. 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)
