{ "openapi": "3.0.1", "info": { "title": "StockX Scraper", "description": "Scrape StockX listings with live market data: lowest ask, highest bid, last sale, 72h/90d/annual sales counts, volatility and price premium on every result. Search, brand, category, or product modes. Optional style ID, colorway, retail price and size matrix. The lowest-priced StockX actor.", "version": "0.0", "x-build-id": "nAd95Bqg36b3PxAkF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~stockx-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-stockx-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/unfenced-group~stockx-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-stockx-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/unfenced-group~stockx-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-stockx-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", "byBrand", "byCategory", "byProduct", "byUrl" ], "type": "string", "description": "What to scrape from StockX.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text query (mode = search). E.g. 'jordan 4', 'yeezy 350', 'rolex submariner', 'pokemon 151'.", "default": "jordan 4" }, "brand": { "title": "Brand slug", "type": "string", "description": "Brand slug (mode = byBrand). Taken from stockx.com/brands/{slug}, e.g. 'jordan', 'nike', 'adidas', 'new-balance', 'supreme', 'rolex'.", "default": "jordan" }, "category": { "title": "Category slug", "type": "string", "description": "Category slug (mode = byCategory). E.g. 'sneakers', 'apparel', 'accessories', 'electronics', 'collectibles', 'trading-cards', 'watches'.", "default": "sneakers" }, "productUrls": { "title": "Product URLs or slugs", "type": "array", "description": "Specific StockX products (mode = byProduct). Full URL or just the slug, e.g. 'air-jordan-4-retro-white-cement-2025'.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Direct URLs", "type": "array", "description": "Direct StockX search, brand or category URLs (mode = byUrl).", "default": [], "items": { "type": "string" } }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "JPY", "AUD", "CAD", "CHF", "HKD", "SGD", "MXN" ], "type": "string", "description": "Currency label applied to output. StockX prices are localized by region; pair with a matching Country.", "default": "USD" }, "country": { "title": "Country / Region", "enum": [ "US", "GB", "DE", "FR", "IT", "ES", "NL", "JP", "AU", "CA", "CH", "HK", "SG", "MX" ], "type": "string", "description": "Region routed through the proxy. Drives localized pricing.", "default": "US" }, "sortBy": { "title": "Sort order", "enum": [ "featured", "most_active", "recently_released", "price_high_to_low", "price_low_to_high" ], "type": "string", "description": "Sort applied to search and browse results.", "default": "featured" }, "fetchDetails": { "title": "Fetch product details", "type": "boolean", "description": "Follow each listing to its product page for style ID, colorway, retail price, restock date and size matrix. Adds one request per product, so it is slower and more expensive on large runs.", "default": false }, "minPrice": { "title": "Minimum price (lowest ask)", "type": "integer", "description": "Drop products with lowest ask below this value." }, "maxPrice": { "title": "Maximum price (lowest ask)", "type": "integer", "description": "Drop products with lowest ask above this value." }, "newOnly": { "title": "New condition only", "type": "boolean", "description": "Keep only products in New condition.", "default": false }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Hard cap on results emitted. Set 0 for no cap (StockX caps each query at 1000).", "default": 5 }, "maxPages": { "title": "Max pages", "minimum": 1, "type": "integer", "description": "Maximum listing pages to walk (each page is up to ~40 products). Max 25.", "default": 5 } } }, "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 } } } } } } } } } }