---
title: "Search Zappos products"
method: GET
path: "/zappos/search"
tags: ["Zappos"]
---

# Search Zappos products

`GET /zappos/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/zappos/search`
- Auth: API key in header `x-api-key`

Searches Zappos's product catalog by keyword, with real page-based pagination. Returns products with brand, pricing, sale status, rating, and review count, plus filterable facets (gender, department, shoe size, and more) each with a live result count and its own drill-down URL. Requesting a page beyond the available results returns a normal, empty result rather than an error.

## Query parameters

- `term` string, required
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ZapposSearchResponseDoc
  - `code` integer
  - `data` ZapposSearchResponse
    - `count` integer
    - `facets` ZapposFacet[]: Facets lists this page's own filterable fields (gender, department, shoe size, etc.), each with live result counts and drill-down URLs -- sourced from the same response this package already fetches, not a separate upstream call. See buildFacets's doc comment.
      - `field` string
      - `multi_select` boolean
      - `name` string
      - `values` ZapposFacetValue[]
        - `count` integer
        - `selected` boolean
        - `url` string
        - `value` string
    - `fetched_at` string
    - `has_more` boolean
    - `page` integer
    - `page_count` integer
    - `page_size` integer
    - `products` ZapposProductSummary[]
      - `brand_name` string
      - `color` string
      - `color_id` string
      - `gender` string[]
      - `image_url` string
      - `is_new` boolean
      - `on_hand` integer
      - `on_sale` boolean
      - `original_price` string
      - `percent_off` string
      - `price` string
      - `product_id` string
      - `product_name` string
      - `product_type` string
      - `rating` number
      - `review_count` integer
      - `style_color` string
      - `style_id` string
      - `url` string
    - `source_url` string
    - `term` string
    - `total_count` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `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/0497899e2016?raw)