# Zappos Product & Price Scraper (`crawlerbros/zappos-product-price-scraper`) Actor

Scrape live shoe, apparel, and accessory listings from Zappos.com - search by keyword, browse by brand or category, or look up full product detail (price, MSRP, rating, images) by URL. No login required.

- **URL**: https://apify.com/crawlerbros/zappos-product-price-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Zappos Product & Price Scraper

Scrape live shoe, apparel, and accessory listings from [Zappos.com](https://www.zappos.com) — search by keyword, browse by brand or category, or pull full product detail (price, MSRP, rating, images) straight from a product URL. No login, no cookies, no paid proxy required.

### What this actor does

- **Search by keyword** — free-text search across Zappos' full catalog (shoes, clothing, bags, accessories, eyewear).
- **Browse by brand** — pick from 160+ known brands (Nike, adidas, UGG, Dr. Martens, Birkenstock, and more) or type a custom brand name.
- **Browse by category** — Boots, Sneakers & Athletic Shoes, Sandals, Heels, Hiking, and 8 more shoe categories.
- **Product detail by URL** — paste one or more Zappos product page URLs to get the full detail record (description, MSRP, availability, gallery images, rating breakdown).
- **Filters** — gender, department, color, shoe width, price range, minimum rating, on-sale only, and client-side sort (Zappos' own sort parameters are unreliable, so this actor re-sorts fetched results deterministically).
- **Color and width filters narrow the actual Zappos result set** (not a post-fetch guess) — the actor chains the requested color/width facet onto the search, brand, or category listing before paginating, the same way Zappos' own filter sidebar does.
- Empty fields are always omitted — every record only contains data actually found on the page.

### Output per product

**Search / browse modes:**
- `productId`, `styleId`, `colorId`
- `productName`, `brandName`, `color`, `styleColor`, `productType`
- `price`, `originalPrice`, `percentOff`, `onSale`, `isNew`
- `productRating`, `reviewRating`, `reviewCount`
- `stockOnHand`, `inStock`
- `gender[]`, `badges[]`
- `productUrl`, `imageUrl`, `swatchImageUrl`
- `availableColors[]` — other colorways of the same style (`colorName`, `colorId`, `price`, `onSale`, `productUrl`), when Zappos exposes them
- `recordType: "product"`, `scrapedAt`

**Product detail mode (adds):**
- `sku`, `category`, `description`
- `priceCurrency`, `availability`, `itemCondition`, `bestRating`
- `brandUrl` — link to the brand's own Zappos page
- `recentReviewRatings[]` — individual customer rating scores pulled from the page's review markup
- `imageUrls[]` (full gallery)

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | `search` / `browseByBrand` / `browseByCategory` / `productDetail` |
| `searchQuery` | string | `running shoes` | Free-text query (mode=search) |
| `brand` | select | `Nike` | Brand to browse (mode=browseByBrand); choose "Other" + `brandOther` for anything not listed |
| `brandOther` | string | – | Custom brand name when `brand` = "Other" |
| `category` | select | `Boots` | Shoe category to browse (mode=browseByCategory) |
| `productUrls` | array | – | Zappos product page URLs, or bare numeric product IDs (mode=productDetail) |
| `gender` | select | `Any` | `Any` / `Women` / `Men` / `Girls` / `Boys` |
| `department` | select | `Any` | `Any` / `Shoes` / `Clothing` / `Accessories` / `Bags` / `Beauty` / `Jewelry` / `Sporting Goods` |
| `color` | select | `Any` | 18 stable Zappos color families, or `Other` + `colorOther` for anything not listed |
| `colorOther` | string | – | Custom color name when `color` = "Other" |
| `width` | select | `Any` | `Narrow` / `Medium` / `Wide` / `Extra Wide` / `Extra-Extra Wide` — applies the width family matching `gender` |
| `minPrice` / `maxPrice` | integer | – | USD price range |
| `minRating` | integer | – | Minimum product rating (1-5) |
| `onSaleOnly` | boolean | `false` | Only products currently discounted |
| `sortBy` | select | `relevance` | `relevance` / `priceLowToHigh` / `priceHighToLow` / `ratingHighToLow` / `mostReviewed` / `newest` |
| `maxItems` | integer | `20` | Hard cap on emitted records (1-500) |

#### Example: search with filters

```json
{
  "mode": "search",
  "searchQuery": "leather boots",
  "gender": "Women",
  "minPrice": 50,
  "maxPrice": 200,
  "onSaleOnly": true,
  "sortBy": "priceLowToHigh",
  "maxItems": 50
}
````

#### Example: browse a brand

```json
{
  "mode": "browseByBrand",
  "brand": "HOKA",
  "gender": "Men",
  "width": "Wide",
  "maxItems": 100
}
```

#### Example: color-filtered search

```json
{
  "mode": "search",
  "searchQuery": "sneakers",
  "color": "Black",
  "department": "Shoes",
  "maxItems": 50
}
```

#### Example: product detail by URL

```json
{
  "mode": "productDetail",
  "productUrls": [
    "https://www.zappos.com/p/on-kids-cloud-play-little-kid-zephyr-white/product/9894346/color/1055772"
  ]
}
```

### FAQs

**Does this actor need a Zappos account or cookies?**
No. All data is read from Zappos' public search, browse, and product pages.

**Why does `sortBy` say Zappos' own sort is unreliable?**
Zappos' `?s=` sort query parameter does not reliably reorder server-side results, so this actor fetches the full result set and re-sorts it deterministically in code.

**What if my brand isn't in the dropdown?**
Set `brand` to `Other` and put the exact brand name in `brandOther`. The same pattern applies to `color` + `colorOther`.

**How does the `width` filter know which sizing family to use?**
Zappos scopes shoe widths by gender (`Women`, `Men`, `Kids`). Set `gender` alongside `width` for a precise match; if `gender` is left at `Any`, the actor checks the Women's width family first, then Men's, then Kids'.

**Why did I get 0 results?**
Either the keyword/brand/category/color/width combination has no matching Zappos facet, or your price/rating filters excluded every match. The run's status message explains which case applies.

# Actor input Schema

## `mode` (type: `string`):

What to fetch from Zappos.

## `searchQuery` (type: `string`):

Free-text keyword search, e.g. `running shoes`, `leather boots`, `Nike Air Max`.

## `brand` (type: `string`):

Pick a brand to browse. Choose "Other (type below)" to enter any brand not listed.

## `brandOther` (type: `string`):

Any Zappos brand name not in the dropdown, e.g. `Vince Camuto`.

## `category` (type: `string`):

Shoe category to browse.

## `productUrls` (type: `array`):

Zappos product page URLs, e.g. `https://www.zappos.com/p/.../product/9894346/color/1055772`.

## `gender` (type: `string`):

Restrict results to a gender/age category (applies to search, browseByBrand, browseByCategory).

## `department` (type: `string`):

Restrict results to a top-level Zappos department (applies to search, browseByBrand, browseByCategory).

## `color` (type: `string`):

Narrow results to a color family (applies to search, browseByBrand, browseByCategory; not productDetail). Choose "Other" to type any color name not listed.

## `colorOther` (type: `string`):

Any Zappos color family name not in the dropdown, e.g. `Navy`.

## `width` (type: `string`):

Narrow shoe results to a specific width. Applies the width family matching `gender` (checks Women's first when Gender = Any). Applies to search, browseByBrand, browseByCategory; not productDetail.

## `minPrice` (type: `integer`):

Drop products cheaper than this.

## `maxPrice` (type: `integer`):

Drop products pricier than this.

## `minRating` (type: `integer`):

Drop products rated below this.

## `onSaleOnly` (type: `boolean`):

Only emit products currently discounted below MSRP.

## `sortBy` (type: `string`):

Client-side re-sort applied after fetching (Zappos' own sort parameters are unreliable).

## `maxItems` (type: `integer`):

Hard cap on emitted records.

## Actor input object example

```json
{
  "mode": "search",
  "searchQuery": "running shoes",
  "brand": "Nike",
  "category": "Boots",
  "productUrls": [],
  "gender": "Any",
  "department": "Any",
  "color": "Any",
  "width": "Any",
  "onSaleOnly": false,
  "sortBy": "relevance",
  "maxItems": 20
}
```

# Actor output Schema

## `products` (type: `string`):

Dataset containing all scraped Zappos products.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "searchQuery": "running shoes",
    "brand": "Nike",
    "category": "Boots",
    "productUrls": [],
    "gender": "Any",
    "department": "Any",
    "color": "Any",
    "width": "Any",
    "onSaleOnly": false,
    "sortBy": "relevance",
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/zappos-product-price-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "searchQuery": "running shoes",
    "brand": "Nike",
    "category": "Boots",
    "productUrls": [],
    "gender": "Any",
    "department": "Any",
    "color": "Any",
    "width": "Any",
    "onSaleOnly": False,
    "sortBy": "relevance",
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/zappos-product-price-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "searchQuery": "running shoes",
  "brand": "Nike",
  "category": "Boots",
  "productUrls": [],
  "gender": "Any",
  "department": "Any",
  "color": "Any",
  "width": "Any",
  "onSaleOnly": false,
  "sortBy": "relevance",
  "maxItems": 20
}' |
apify call crawlerbros/zappos-product-price-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=crawlerbros/zappos-product-price-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Zappos Product & Price Scraper",
        "description": "Scrape live shoe, apparel, and accessory listings from Zappos.com - search by keyword, browse by brand or category, or look up full product detail (price, MSRP, rating, images) by URL. No login required.",
        "version": "1.0",
        "x-build-id": "C4LH3hN689iBKtecO"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/crawlerbros~zappos-product-price-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-crawlerbros-zappos-product-price-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/crawlerbros~zappos-product-price-scraper/runs": {
            "post": {
                "operationId": "runs-sync-crawlerbros-zappos-product-price-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/crawlerbros~zappos-product-price-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-crawlerbros-zappos-product-price-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "search",
                            "browseByBrand",
                            "browseByCategory",
                            "productDetail"
                        ],
                        "type": "string",
                        "description": "What to fetch from Zappos.",
                        "default": "search"
                    },
                    "searchQuery": {
                        "title": "Search query (mode=search)",
                        "type": "string",
                        "description": "Free-text keyword search, e.g. `running shoes`, `leather boots`, `Nike Air Max`.",
                        "default": "running shoes"
                    },
                    "brand": {
                        "title": "Brand (mode=browseByBrand)",
                        "enum": [
                            "Other",
                            "ALDO",
                            "ASICS",
                            "Alegria",
                            "AllSaints",
                            "Altra",
                            "Anne Klein",
                            "Anodyne",
                            "Arc'teryx",
                            "Athletic Propulsion Labs (APL)",
                            "Baffin",
                            "Bates Footwear",
                            "Bearpaw",
                            "Bernardo",
                            "Birdies",
                            "Birkenstock",
                            "Bloch",
                            "Blowfish Malibu",
                            "Bogs",
                            "Born",
                            "Brooks",
                            "CHARLY",
                            "COACH",
                            "Chinese Laundry",
                            "Clarks",
                            "Cole Haan",
                            "Columbia",
                            "Comfortiva",
                            "Converse",
                            "Craft",
                            "Crocs",
                            "DC",
                            "DV Dolce Vita",
                            "Dan Post",
                            "Danner",
                            "Dansko",
                            "Deer Stags",
                            "Dingo",
                            "Dockers",
                            "Dolce Vita",
                            "Dr. Martens",
                            "Dr. Scholl's",
                            "Durango",
                            "ECCO",
                            "Eastland 1955 Edition",
                            "Easy Spirit",
                            "Enda",
                            "Eric Michael",
                            "FitFlop",
                            "Floafers",
                            "Florsheim",
                            "FootMates",
                            "Free People",
                            "French Sole",
                            "GFORE",
                            "GREATS",
                            "Gabor",
                            "Gola",
                            "Gravity Defyer",
                            "Ground Up",
                            "HOKA",
                            "Haflinger",
                            "Helly Hansen",
                            "Hey Dude",
                            "Hunter",
                            "INOV8",
                            "J. Renee",
                            "Jack Rogers",
                            "Jessica Simpson",
                            "Johnston & Murphy",
                            "Josmo",
                            "Journee Collection",
                            "KEEN",
                            "KIZIK",
                            "Kamik",
                            "Kate Spade New York",
                            "Kenneth Cole",
                            "Koolaburra by UGG",
                            "L'Amour Shoes",
                            "L'Artiste by Spring Step",
                            "L.L.Bean",
                            "La Canadienne",
                            "La Sportiva",
                            "Lacoste",
                            "LifeStride",
                            "Loeffler Randall",
                            "Lowa",
                            "MIA",
                            "Marc Joseph New York",
                            "Mephisto",
                            "Merrell",
                            "Michael Kors",
                            "Mizuno",
                            "Moxie Trades",
                            "Naot",
                            "Native Shoes",
                            "Naturalizer",
                            "Naturino",
                            "New Balance",
                            "Nike",
                            "Nunn Bush",
                            "OOFOS",
                            "Oboz",
                            "OluKai",
                            "On",
                            "Orthofeet",
                            "PUMA",
                            "Polo Ralph Lauren",
                            "Propet",
                            "Reebok",
                            "Reef",
                            "Revere",
                            "Rieker",
                            "Rockport",
                            "Roper",
                            "Rothy's",
                            "Roxy",
                            "Ryka",
                            "SALEWA",
                            "SAS",
                            "SKECHERS",
                            "SOREL",
                            "Salomon",
                            "Sam Edelman",
                            "Sanuk",
                            "Saucony",
                            "Scarpa",
                            "See Kai Run",
                            "Seychelles",
                            "SoftWalk",
                            "Soludos",
                            "Soléi Sea",
                            "Sperry",
                            "Spring Step",
                            "Steve Madden",
                            "Stride Rite",
                            "TOMS",
                            "TYR",
                            "Tecovas",
                            "Teva",
                            "The North Face",
                            "To Boot New York",
                            "Tommy Hilfiger",
                            "Toni Pons",
                            "Topo Athletic",
                            "Tory Burch",
                            "Trotters",
                            "Tsukihoshi Kids",
                            "Twisted X",
                            "UGG",
                            "Under Armour",
                            "VEJA",
                            "VIONIC",
                            "Vance",
                            "Vans",
                            "Veronica Beard",
                            "Vibram FiveFingers",
                            "Vince",
                            "Vince Camuto",
                            "Vintage Havana",
                            "Volcom",
                            "Wilson",
                            "Wolf & Shepherd",
                            "Xero Shoes",
                            "Yosi Samra",
                            "Zamberlan",
                            "adidas",
                            "johnnie-O",
                            "sparco",
                            "victoria"
                        ],
                        "type": "string",
                        "description": "Pick a brand to browse. Choose \"Other (type below)\" to enter any brand not listed.",
                        "default": "Nike"
                    },
                    "brandOther": {
                        "title": "Custom brand (used when Brand = \"Other\")",
                        "type": "string",
                        "description": "Any Zappos brand name not in the dropdown, e.g. `Vince Camuto`."
                    },
                    "category": {
                        "title": "Category (mode=browseByCategory)",
                        "enum": [
                            "Boots",
                            "Sneakers & Athletic Shoes",
                            "Sandals",
                            "Flats",
                            "Heels",
                            "Loafers",
                            "Oxfords",
                            "Slippers",
                            "Hiking",
                            "Boat Shoes",
                            "Clogs",
                            "Crib Shoes",
                            "Climbing"
                        ],
                        "type": "string",
                        "description": "Shoe category to browse.",
                        "default": "Boots"
                    },
                    "productUrls": {
                        "title": "Product URLs (mode=productDetail)",
                        "type": "array",
                        "description": "Zappos product page URLs, e.g. `https://www.zappos.com/p/.../product/9894346/color/1055772`.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "gender": {
                        "title": "Gender filter",
                        "enum": [
                            "Any",
                            "Women",
                            "Men",
                            "Girls",
                            "Boys"
                        ],
                        "type": "string",
                        "description": "Restrict results to a gender/age category (applies to search, browseByBrand, browseByCategory).",
                        "default": "Any"
                    },
                    "department": {
                        "title": "Department filter",
                        "enum": [
                            "Any",
                            "Shoes",
                            "Clothing",
                            "Accessories",
                            "Bags",
                            "Beauty",
                            "Jewelry",
                            "Sporting Goods"
                        ],
                        "type": "string",
                        "description": "Restrict results to a top-level Zappos department (applies to search, browseByBrand, browseByCategory).",
                        "default": "Any"
                    },
                    "color": {
                        "title": "Color filter",
                        "enum": [
                            "Any",
                            "Black",
                            "White",
                            "Gray",
                            "Blue",
                            "Pink",
                            "Brown",
                            "Multi",
                            "Green",
                            "Tan",
                            "Purple",
                            "Ivory",
                            "Red",
                            "Gold",
                            "Orange",
                            "Silver",
                            "Yellow",
                            "Animal Print",
                            "Clear",
                            "Other"
                        ],
                        "type": "string",
                        "description": "Narrow results to a color family (applies to search, browseByBrand, browseByCategory; not productDetail). Choose \"Other\" to type any color name not listed.",
                        "default": "Any"
                    },
                    "colorOther": {
                        "title": "Custom color (used when Color = \"Other\")",
                        "type": "string",
                        "description": "Any Zappos color family name not in the dropdown, e.g. `Navy`."
                    },
                    "width": {
                        "title": "Width filter (shoes)",
                        "enum": [
                            "Any",
                            "Narrow",
                            "Medium",
                            "Wide",
                            "Extra Wide",
                            "Extra-Extra Wide"
                        ],
                        "type": "string",
                        "description": "Narrow shoe results to a specific width. Applies the width family matching `gender` (checks Women's first when Gender = Any). Applies to search, browseByBrand, browseByCategory; not productDetail.",
                        "default": "Any"
                    },
                    "minPrice": {
                        "title": "Min price (USD)",
                        "minimum": 0,
                        "maximum": 100000,
                        "type": "integer",
                        "description": "Drop products cheaper than this."
                    },
                    "maxPrice": {
                        "title": "Max price (USD)",
                        "minimum": 0,
                        "maximum": 100000,
                        "type": "integer",
                        "description": "Drop products pricier than this."
                    },
                    "minRating": {
                        "title": "Min product rating (1-5)",
                        "minimum": 1,
                        "maximum": 5,
                        "type": "integer",
                        "description": "Drop products rated below this."
                    },
                    "onSaleOnly": {
                        "title": "On sale only",
                        "type": "boolean",
                        "description": "Only emit products currently discounted below MSRP.",
                        "default": false
                    },
                    "sortBy": {
                        "title": "Sort results by",
                        "enum": [
                            "relevance",
                            "priceLowToHigh",
                            "priceHighToLow",
                            "ratingHighToLow",
                            "mostReviewed",
                            "newest"
                        ],
                        "type": "string",
                        "description": "Client-side re-sort applied after fetching (Zappos' own sort parameters are unreliable).",
                        "default": "relevance"
                    },
                    "maxItems": {
                        "title": "Max items",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Hard cap on emitted records.",
                        "default": 20
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
