{ "openapi": "3.0.1", "info": { "title": "Skechers Scraper", "description": "Scrape Skechers.com - search products, browse 50+ shoe/clothing categories by gender and type, or look up exact products by style ID. Get price, sale/original price, color, gender, category, images, and PowerReviews ratings. No auth, no proxy required.", "version": "1.0", "x-build-id": "ChAAGQJREq1es6e0u" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~skechers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-skechers-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~skechers-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-skechers-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~skechers-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-skechers-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", "byCategory", "byProductId" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text query (mode=search), e.g. `slip on sneakers` or `hiking boots`.", "default": "slip on sneakers" }, "category": { "title": "Category (mode=byCategory)", "enum": [ "men", "women", "kids", "sale", "clothingAccessories", "menShoesAthleticSneakers", "menShoesBoatShoes", "menShoesBoots", "menShoesCasualSneakers", "menShoesConstruction", "menShoesDressShoes", "menShoesExtraWideFit", "menShoesHospitality", "menShoesLaceUp", "menShoesSandals", "menShoesSlipOns", "menShoesSlippers", "menShoesWideFit", "menShoesWorkSafety", "womenShoesAthleticSneakers", "womenShoesBoatShoes", "womenShoesBoots", "womenShoesCasualSneakers", "womenShoesFlats", "womenShoesHospitality", "womenShoesLaceUp", "womenShoesMaryJane", "womenShoesSandals", "womenShoesSlipOns", "womenShoesSlippers", "womenShoesWedges", "womenShoesWideFit", "womenShoesWorkSafety", "kidsBoysAthleticSneakers", "kidsBoysBoots", "kidsBoysHandsFreeSlipIns", "kidsBoysInfantToddler", "kidsBoysLaceUps", "kidsBoysLightUpShoes", "kidsBoysSandals", "kidsBoysSlipOns", "kidsGirlsAthleticSneakers", "kidsGirlsBoots", "kidsGirlsHandsFreeSlipIns", "kidsGirlsInfantToddler", "kidsGirlsLaceUps", "kidsGirlsLightUpShoes", "kidsGirlsSandals", "kidsGirlsSlipOns", "clothingMensAccessories", "clothingMensBottoms", "clothingMensJacketsCoats", "clothingMensTops", "clothingWomensAccessories", "clothingWomensBottoms", "clothingWomensJacketsCoats", "clothingWomensTops" ], "type": "string", "description": "Pick a curated Skechers category. For a category not listed, use `customCategoryId` instead.", "default": "womenShoesAthleticSneakers" }, "customCategoryId": { "title": "Custom category ID (advanced, mode=byCategory)", "type": "string", "description": "Overrides `category` with any raw Skechers category id (`cgid`) — find it in a skechers.com category page URL's `cgid=` query param. Use when the category you want isn't in the curated dropdown." }, "productIds": { "title": "Product / style IDs (mode=byProductId)", "type": "array", "description": "Skechers style IDs (`177197`), style+color SKUs (`177197_NVY`), or full product URLs.", "default": [], "items": { "type": "string" } }, "gender": { "title": "Gender filter", "enum": [ "", "Men", "Women", "Boys", "Girls" ], "type": "string", "description": "Only emit products matching this gender/age group. Leave blank for no filter.", "default": "" }, "sortBy": { "title": "Sort order", "enum": [ "bestMatches", "newest", "topSellers", "priceHighToLow", "priceLowToHigh", "percentOff" ], "type": "string", "description": "Result ordering (search / browse by category).", "default": "bestMatches" }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Drop products cheaper than this." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Drop products pricier than this." }, "width": { "title": "Width (mode=byCategory)", "enum": [ "", "Medium", "Wide", "Extra Wide" ], "type": "string", "description": "Only emit products offered in this width. Applies to `byCategory` only — Skechers' free-text search index doesn't support this facet.", "default": "" }, "colorFamily": { "title": "Color family (mode=byCategory)", "enum": [ "", "Beige", "Black", "Blue", "Brown", "Green", "Grey", "Navy", "Pink", "Purple", "Red", "White", "Yellow" ], "type": "string", "description": "Only emit products in this swatch color family. Applies to `byCategory` only — Skechers' free-text search index doesn't support this facet.", "default": "" }, "technology": { "title": "Comfort technology (mode=byCategory)", "enum": [ "", "Air-Cooled Goga Mat", "Air-Cooled Memory Foam", "Arch Fit", "Contour Foam", "Cozy Fit", "Glide-Step", "Hyper Burst", "Max Cushioning", "Memory Foam", "Relaxed Fit", "Skech-Air", "Slip-Ins", "Stretch Fit", "Twist Fit", "Ultra Go" ], "type": "string", "description": "Only emit products featuring this comfort/cushioning technology. Applies to `byCategory` only — Skechers' free-text search index doesn't support this facet.", "default": "" }, "style": { "title": "Style / shape (mode=byCategory)", "enum": [ "", "Boat", "Boot", "Bootie", "Cleat", "Clog", "Flat", "Loafer", "Mary Jane", "Mule", "Open Back", "Oxford", "Platform", "Sandal", "Skimmer", "Slip-On", "Slipper", "Sneaker", "Sneaker Boot", "Wedge" ], "type": "string", "description": "Only emit products of this shoe shape/style. Applies to `byCategory` only — Skechers' free-text search index doesn't support this facet.", "default": "" }, "comfortCollection": { "title": "Comfort collection (mode=byCategory)", "enum": [ "", "BOBS", "Cali", "D'Lites", "Foamies", "GO GOLF", "Goldcrown", "GO RUN", "GO WALK", "John Deere", "Mark Nason", "Our Planet Matters", "Pickleball", "Sport", "UNOs", "Work" ], "type": "string", "description": "Only emit products from this named Skechers product line/collection. Applies to `byCategory` only — Skechers' free-text search index doesn't support this facet.", "default": "" }, "comfortFeature": { "title": "Comfort feature (mode=byCategory)", "enum": [ "", "Breathable", "Breathable Comfort", "Electrical Hazard", "Electrostatic Dissipative", "Faux Fur Lining", "Goodyear Rubber", "Lights", "Machine Washable", "No Tie Fit", "Recycled", "Safety Toe", "Slip Resistant", "Vegan", "Waterproof" ], "type": "string", "description": "Only emit products with this construction/care feature. Applies to `byCategory` only — Skechers' free-text search index doesn't support this facet.", "default": "" }, "apparelStyle": { "title": "Apparel style (mode=byCategory, clothing categories)", "enum": [ "", "Dresses", "Headwear", "Hoodies", "Jackets and Coats", "Leggings", "Long Sleeved Tops", "Pants", "Polos and Shirts", "Short Sleeved Tees", "Shorts", "Skorts", "Sports Bras", "Sweaters", "Tanks" ], "type": "string", "description": "Only emit products of this apparel style/cut. Applies to the `clothing*` categories only (e.g. `clothingWomensTops`, `clothingMensBottoms`) — has no effect (0 results) on shoe categories.", "default": "" }, "productLine": { "title": "Product line (mode=byCategory)", "enum": [ "", "FOOTWEAR", "APPAREL", "ACCESSORIES", "BAGS" ], "type": "string", "description": "Only emit products of this top-level product type. Most useful on mixed categories that interleave footwear/apparel/accessories/bags (`men`, `women`, `kids`, `sale`, `clothingAccessories`) — has no effect (0 results) on already single-type categories, e.g. `APPAREL` on a pure shoe category. Applies to `byCategory` only.", "default": "" }, "occasion": { "title": "Occasion (mode=byCategory)", "enum": [ "", "Athletic", "Casual", "Cold Weather", "Dress", "Fashion", "Work" ], "type": "string", "description": "Only emit products tagged for this occasion/use-case. Applies to `byCategory` only — Skechers' free-text search index doesn't support this facet. Not every value is offered by every category — an unsupported combination correctly returns 0 rather than a wrong match.", "default": "" }, "size": { "title": "US shoe size (mode=byCategory)", "minimum": 1, "maximum": 20, "type": "number", "description": "Only emit products available in this US shoe size (e.g. `8`, `8.5` — enter half sizes like `8.5`). Applies to `byCategory` only. Works across all age groups (Men/Women/Kids/Toddler) using each category's own real size range — a value outside what that category actually offers (e.g. an adult size in a toddler category) correctly returns 0 rather than a wrong match." }, "kidsAgeGroup": { "title": "Kids age group (mode=byCategory)", "enum": [ "", "toddlers", "littleKids", "bigKids" ], "type": "string", "description": "Only emit kids' products in this Skechers age/size bucket. Applies to `byCategory` only — Skechers' free-text search index doesn't support this facet. Has no effect (0 results) on non-kids categories.", "default": "" }, "onSaleOnly": { "title": "On sale only", "type": "boolean", "description": "Only emit products currently discounted below their original price.", "default": false }, "includeRatings": { "title": "Include ratings (mode=byProductId)", "type": "boolean", "description": "Fetch average rating + review count from the public PowerReviews widget for each product ID. Adds one extra request per item.", "default": true }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on emitted records.", "default": 24 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. The actor works without a proxy; this is only used as an automatic fallback if Skechers starts blocking requests (403/429).", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }