Other

Zappos API

Zappos API returns live Zappos data as clean JSON for zappos The primary endpoint, search, returns product results including product id, style id, color id, name and brand.

2 actionsLive JSON1,000 free creditsMCP-ready

Get a free key Open in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

Developers reach for it when they need to validate, enrich, classify and normalize operational data without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Zappos scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, product_detail. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Aug 6, 2026, 11:05 AM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/zappos/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "running shoes",
    "max_results": 40
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "zappos",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1543,
    "record_count": 40,
    "bytes": 1401728,
    "cache_hit": false,
    "completeness_pct": 100,
    "stop_reason": "limit_reached",
    "method": "ssr_json_island",
    "pagination": {
      "page": 1,
      "per_page": 100,
      "total_results": 2150,
      "page_count": 22,
      "returned": 40,
      "has_more": true,
      "next_page": 2
    },
    "filters": {
      "applied": [],
      "ignored": []
    }
  },
  "data": {
    "products": [
      {
        "product_id": "10046215",
        "style_id": "6666744",
        "color_id": "147392",
        "name": "[redacted-name]",
        "brand": "ASICS",
        "product_type": "Shoes",
        "color": "Black",
        "color_detail": "Black/Pure Silver",
        "genders": [
          "Boys",
          "Girls"
        ],
        "url": "https://www.zappos.com/p/asics-kids-gel-1130-pre-school-little-kid-toddler-black-pure-silver/product/10046215/color/147392",
        "price": 75,
        "original_price": 75,
        "currency": "USD",
        "on_sale": false,
        "percent_off": 0,
        "discount_amount": null,
        "in_stock": true,
        "units_available": 11,
        "low_stock": null,
        "is_new": true,
        "rating": 0,
        "style_rating": 0,
        "review_count": 0,
        "image": "https://m.media-amazon.com/images/I/81lry1Uf2lL._SX700_.jpg",
        "images": [
          {
            "view": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          },
          {
            "view": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          },
          {
            "view": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          }
        ],
        "swatch_image": null,
        "has_fabric_swatch": false,
        "is_couture": false,
        "badges": [
          "NEW"
        ],
        "promo_badges": null,
        "other_colors": null
      },
      {
        "product_id": "10048623",
        "style_id": "6699906",
        "color_id": "1137050",
        "name": "[redacted-name]",
        "brand": "Brooks",
        "product_type": "Shoes",
        "color": "Purple",
        "color_detail": "Raisin/Purple/Metallic",
        "genders": [
          "Women"
        ],
        "url": "https://www.zappos.com/p/brooks-ghost-max-4-raisin-purple-metallic/product/10048623/color/1137050",
        "price": 164.95,
        "original_price": 164.95,
        "currency": "USD",
        "on_sale": false,
        "percent_off": 0,
        "discount_amount": null,
        "in_stock": true,
        "units_available": 738,
        "low_stock": null,
        "is_new": true,
        "rating": 0,
        "style_rating": 0,
        "review_count": 0,
        "image": "https://m.media-amazon.com/images/I/81hf3HD5eGL._SX700_.jpg",
        "images": [
          {
            "view": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          },
          {
            "view": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          },
          {
            "view": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          }
        ],
        "swatch_image": "https://swch-cl2.olympus.zappos.com/base/27567/27580/10048623/6699906.jpg",
        "has_fabric_swatch": false,
        "is_couture": false,
        "badges": [
          "NEW"
        ],
        "promo_badges": null,
        "other_colors": [
          {
            "style_id": "[trimmed-depth]",
            "color_id": "[trimmed-depth]",
            "color": "[trimmed-depth]",
            "color_detail": "[trimmed-depth]",
            "price": "[trimmed-depth]",
            "original_price": "[trimmed-depth]",
            "percent_off": "[trimmed-depth]",
            "units_available": "[trimmed-depth]",
            "rating": "[trimmed-depth]",
            "review_count": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          },
          {
            "style_id": "[trimmed-depth]",
            "color_id": "[trimmed-depth]",
            "color": "[trimmed-depth]",
            "color_detail": "[trimmed-depth]",
            "price": "[trimmed-depth]",
            "original_price": "[trimmed-depth]",
            "percent_off": "[trimmed-depth]",
            "units_available": "[trimmed-depth]",
            "rating": "[trimmed-depth]",
            "review_count": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          },
          {
            "style_id": "[trimmed-depth]",
            "color_id": "[trimmed-depth]",
            "color": "[trimmed-depth]",
            "color_detail": "[trimmed-depth]",
            "price": "[trimmed-depth]",
            "original_price": "[trimmed-depth]",
            "percent_off": "[trimmed-depth]",
            "units_available": "[trimmed-depth]",
            "rating": "[trimmed-depth]",
            "review_count": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          }
        ]
      },
      {
        "product_id": "10048552",
        "style_id": "6674631",
        "color_id": "1131642",
        "name": "[redacted-name]",
        "brand": "Brooks",
        "product_type": "Shoes",
        "color": "Gray",
        "color_detail": "Grey/Grey/Ebony",
        "genders": [
          "Men"
        ],
        "url": "https://www.zappos.com/p/brooks-ghost-max-4-grey-grey-ebony/product/10048552/color/1131642",
        "price": 164.95,
        "original_price": 164.95,
        "currency": "USD",
        "on_sale": false,
        "percent_off": 0,
        "discount_amount": null,
        "in_stock": true,
        "units_available": 960,
        "low_stock": null,
        "is_new": true,
        "rating": 0,
        "style_rating": 0,
        "review_count": 0,
        "image": "https://m.media-amazon.com/images/I/818MQ6sgueL._SX700_.jpg",
        "images": [
          {
            "view": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          },
          {
            "view": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          },
          {
            "view": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          }
        ],
        "swatch_image": "https://swch-cl2.olympus.zappos.com/fabric/27567/27580/10048552/6674631.jpg",
        "has_fabric_swatch": true,
        "is_couture": false,
        "badges": [
          "NEW"
        ],
        "promo_badges": null,
        "other_colors": [
          {
            "style_id": "[trimmed-depth]",
            "color_id": "[trimmed-depth]",
            "color": "[trimmed-depth]",
            "color_detail": "[trimmed-depth]",
            "price": "[trimmed-depth]",
            "original_price": "[trimmed-depth]",
            "percent_off": "[trimmed-depth]",
            "units_available": "[trimmed-depth]",
            "rating": "[trimmed-depth]",
            "review_count": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          },
          {
            "style_id": "[trimmed-depth]",
            "color_id": "[trimmed-depth]",
            "color": "[trimmed-depth]",
            "color_detail": "[trimmed-depth]",
            "price": "[trimmed-depth]",
            "original_price": "[trimmed-depth]",
            "percent_off": "[trimmed-depth]",
            "units_available": "[trimmed-depth]",
            "rating": "[trimmed-depth]",
            "review_count": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          },
          {
            "style_id": "[trimmed-depth]",
            "color_id": "[trimmed-depth]",
            "color": "[trimmed-depth]",
            "color_detail": "[trimmed-depth]",
            "price": "[trimmed-depth]",
            "original_price": "[trimmed-depth]",
            "percent_off": "[trimmed-depth]",
            "units_available": "[trimmed-depth]",
            "rating": "[trimmed-depth]",
            "review_count": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "url": "[trimmed-depth]"
          }
        ]
      }
    ],
    "__trimmed": "response capped for page display"
  }
}

Actions

What the Zappos API does

Action	Description	Concrete use case	Key params
search	Search the Zappos catalog. Give a `query` ('running shoes', 'hiking boots', 'nike air max', 'womens dresses') and get back 100 products per page, each with Zappos' own product id, style id and colour id, price and list price, discount, units in stock, star rating, review count, badges, the full image set, and the product's OTHER colourways inline. Narrow with brand, colour, gender, size, width, department, category, material, style, feature, occasion, pattern, theme, price bucket and an on-sale switch; sort by price, rating, newest or best sellers. Every filter value your query actually supports — with the number of products behind it — is returned in `filters_available`, so you never have to guess.	Ops teams call search to search the Zappos catalog.	query, max_results, page, sort, brand, ...
product_detail	Get one Zappos product in full, by its product id (or its zappos.com URL) — brand, category, gender, the marketing description and every specification bullet, the parsed physical measurements (weight, heel height, shaft, circumference, platform height, bag depth and strap drop where Zappos lists them), size charts, the customer rating with its star histogram and the runs-small / runs-wide / arch-support breakdowns, and the two customer reviews Zappos embeds. Every colourway is returned with its own style id, colour id, price, list price, image set and stock, and the selected colourway is broken down to the SIZE x WIDTH level: one row per purchasable variant with Zappos' stock id, the Amazon ASIN, the manufacturer UPC, that variant's own price and list price, and how many units are in stock right now.	Developer tools call product_detail to get one Zappos product in full, by its product id (or its zappos.com URL).	product_id, color_id, style_id, url, include_all_color_variants

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/zappos/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"running shoes","max_results":40}'

import requests

r = requests.post(
    "https://api.reefapi.com/zappos/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "running shoes",
  "max_results": 40
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/zappos/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "running shoes",
  "max_results": 40
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.zappos.search with {"query":"running shoes","max_results":40}.

Use cases

Who uses this API and why

Ops teams use Zappos to search the Zappos catalog.
Developer tools use Zappos to get one Zappos product in full, by its product id (or its zappos.com URL).
Validation workflows use Zappos to validate, enrich, classify and normalize operational data, all from one ReefAPI key and credit pool.

FAQ

Questions developers ask before integrating

What is the Zappos API?

Zappos API is a ReefAPI endpoint group for zappos It returns live JSON through POST requests under /zappos/v1.

Is the Zappos API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Zappos calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Zappos login or account?

No login to Zappos is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Zappos data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Zappos API use?

Zappos actions currently cost 1-2 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call Zappos from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call zappos actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Zappos API a Zappos scraper?

It is the managed alternative to a DIY Zappos scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same zappos back as clean JSON.

Why does my Zappos scraper keep getting blocked?

Most Zappos scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / zappos

Zappos

base /zappos/v12 endpoints

post/zappos/v1/search1 credit

Search the Zappos catalog. Give a `query` ('running shoes', 'hiking boots', 'nike air max', 'womens dresses') and get back 100 products per page, each with Zappos' own product id, style id and colour id, price and list price, discount, units in stock, star rating, review count, badges, the full image set, and the product's OTHER colourways inline. Narrow with brand, colour, gender, size, width, department, category, material, style, feature, occasion, pattern, theme, price bucket and an on-sale switch; sort by price, rating, newest or best sellers. Every filter value your query actually supports — with the number of products behind it — is returned in `filters_available`, so you never have to guess.

Parameter		Allowed / range	Description
query	required	—	What to search for on zappos.com — a category ('running shoes', 'hiking boots', 'womens dresses'), a brand + category ('nike air max', 'ugg slippers'), or a product name. Zappos auto-narrows obvious queries to a department (searching 'running shoes' selects Shoes for you); whatever it decided is reported back in `applied_filters`.
max_results = 100	optional	1–400	How many products to return (1-400). Zappos paginates 100 per page; asking for more than 100 fetches the following pages automatically, up to four.
page = 1	optional	1–100	Which result page to start from (1-based, 100 products per page). Page until `meta.pagination.has_more` is false.
sort	optional	relevance · newest · rating · best_sellers · price_low · price_high	Result ordering, using Zappos' own six options. Omit for Zappos' relevance ranking. NOTE (measured, not a bug): every ordering other than relevance also DROPS the products that have no value for the sort key — sorting 'hiking boots' by rating takes the result count from 462 to 343, because 119 products have no rating yet. `meta.pagination.total_results` always reports the count for the request you actually made.
brand	optional	—	Only this brand, written the way Zappos writes it (Nike, adidas, Merrell, UGG, Dr. Martens). The full brand list for your query, with result counts, comes back in `filters_available.realBrandNameFacet`.
color	optional	—	Only this colour family — Zappos groups colours into about fourteen families (Black, Brown, Gray, White, Blue, Green, Red, Pink, Purple, Tan, Multi, Metallic, Yellow, Orange). Live values in `filters_available.colorFacet`.
gender	optional	—	Men, Women, Boys or Girls — Zappos' own audience facet. Live values in `filters_available.txAttrFacet_Gender`.
size	optional	—	Only products available in this size. Zappos uses a different size facet per audience (Men's Shoe Size, Women's Shoe Size, Kids' Shoe Sizes, clothing sizes), so pass the size the way it is printed — '10', '10.5', 'Large', '8 Toddler' — and the engine picks the size facet your query actually offers. Live values are the `filters_available` entries whose label contains 'Size'.
width	optional	—	Only products available in this width — Narrow, Medium, Wide, Extra Wide, Extra-Extra Wide (footwear only). Live values are the `filters_available` entries whose label contains 'Width'.
category	optional	—	Zappos' second-level category (Boots, Sneakers & Athletic Shoes, Sandals, Hiking, Dresses, Backpacks…). Live values in `filters_available.zc2`.
department	optional	—	Zappos' top-level department (Shoes, Clothing, Bags, Accessories, Eyewear, Watches). Live values in `filters_available.zc1`.
material	optional	—	Leather, Suede, Canvas, Mesh, Nylon, Rubber, Synthetic, Textile. Live values in `filters_available.txAttrFacet_Materials`.
style	optional	—	Zappos' style facet (Athletic, Bootie, Chukka, Comfort, Duck Boot, Western…). Live values in `filters_available.txAttrFacet_Styles`.
feature	optional	—	A product feature Zappos tags (Waterproof, Arch Support, Insulated, Lightweight, Slip Resistant, Moisture Wicking…). Live values in `filters_available.txAttrFacet_Features`.
occasion	optional	—	Athletic, Casual, Dress, Outdoor, Work & Duty. Live values in `filters_available.txAttrFacet_Occasion`.
pattern	optional	—	Camo, Distressed, Logo, Quilted, Solid, Woven… Live values in `filters_available.txAttrFacet_Pattern`.
theme	optional	—	Action Sports, Summer, Western, Winter. Live values in `filters_available.txAttrFacet_Theme`.
price_range	optional	—	One of Zappos' price buckets — '$50 and Under', '$100 and Under', '$200 and Under', '$200 and Over'. Zappos publishes buckets, not a free min/max range; live values in `filters_available.priceFacet`.
on_sale = false	optional	—	Only products Zappos currently marks as on sale.

Try in playground →

post/zappos/v1/product_detail2 credits

Get one Zappos product in full, by its product id (or its zappos.com URL) — brand, category, gender, the marketing description and every specification bullet, the parsed physical measurements (weight, heel height, shaft, circumference, platform height, bag depth and strap drop where Zappos lists them), size charts, the customer rating with its star histogram and the runs-small / runs-wide / arch-support breakdowns, and the two customer reviews Zappos embeds. Every colourway is returned with its own style id, colour id, price, list price, image set and stock, and the selected colourway is broken down to the SIZE x WIDTH level: one row per purchasable variant with Zappos' stock id, the Amazon ASIN, the manufacturer UPC, that variant's own price and list price, and how many units are in stock right now.

Parameter		Allowed / range	Description
product_id	required	—	Zappos' own PRODUCT id — the number in a zappos.com/product/<id> URL, the `sku` in their schema.org data, and the `product_id` on every `search` result. Always a string of digits; never hashed, composed or re-derived. A style id is NOT accepted here (Zappos does not serve /product/<styleId>) — pass it as `style_id` instead. You may pass the full product URL in `url` rather than this.
color_id	optional	—	Which colourway to put in `selected_color`. Zappos' own colour id, exactly as `search` returns it. Omit to get the colourway Zappos shows by default. If the id does not belong to this product the call fails with NOT_FOUND and lists the ids that do — it never quietly returns a different colour.
style_id	optional	—	Alternative colour selector: Zappos' STYLE id (their SKU for one colourway of one product), as returned by `search`. Resolved to its colour inside the product payload, so it costs no extra request. Use `color_id` OR `style_id`.
url	optional	—	A full zappos.com product URL — an alternative to `product_id` (+ `color_id`). Both the short /product/<id>/color/<id> form and the long /p/<slug>/product/<id>/color/<id> form are accepted.
include_all_color_variants = false	optional	—	By default the per-size variant list (stock id, ASIN, UPC, price, units in stock) is returned for the SELECTED colour, and the other colourways come back summarised (price, price range, in-stock flag, variant count). Set true to get the full size grid for EVERY colourway in one response — no extra request, just a much larger payload (a 22-colour sneaker is ~370 variants).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/zappos/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"running shoes","max_results":40}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}