# Zappos Search API Documentation

<p><strong>Zappos Search API Documentation</strong> Search public Zappos products by keyword. Filter by brand, category and 1-based page, and sort by relevance, price, rating or newest. Every row carries its product id, style id, name, brand, numeric price and sale price with discount, rating and review count, stock, full-size image url and product url. A zero rating or review count is returned as null. Prices are US dollars. Rows returned respect every requested filter. An empty search is a successful, billable response with an empty list. Each request costs 1 credit; a failed request is never billed.</p>

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

## 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 |
| --- | --- | --- | --- |
| `query` | string | Yes | Search keyword, for example running shoes. Required. |
| `brand` | string | No | Brand name filter, for example Nike. |
| `category` | string | No | Category value from a search result, for example Shoes. |
| `sort` | string | No | relevance, price_low, price_high, rating_high or newest. |
| `page` | integer | No | 1-based page, default 1. |

## Example response

```json
{
    "data": {
        "query": "running shoes",
        "results": [
            {
                "url": "https://www.zappos.com/product",
                "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",
                "availability": {
                    "on_hand": 14,
                    "in_stock": true
                }
            }
        ],
        "sort_by": "relevance",
        "currency": "USD",
        "pagination": {
            "per_page": 24,
            "current_page": 1,
            "has_next_page": true,
            "total_results": 1051
        },
        "sort_options": [
            "relevance",
            "price_low",
            "price_high",
            "rating_high",
            "newest"
        ]
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "duration_ms": 470,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter 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)
