{ "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 } } } } } } } } } }