{
"openapi": "3.0.1",
"info": {
"title": "StockX Universal Scraper",
"description": "👟 Scrape StockX by keyword or URL: sneakers, streetwear, cards, watches and more. Get lowest ask, highest bid, last sale, sales volume, volatility and price premium per product and per size, in any currency. Product details, GTINs and color family. Cookies optional, pay per result.",
"version": "0.1",
"x-build-id": "mK5oteqDHh4YXMH6I"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapifier~stockx-universal-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapifier-stockx-universal-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/scrapifier~stockx-universal-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapifier-stockx-universal-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/scrapifier~stockx-universal-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapifier-stockx-universal-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",
"properties": {
"queries": {
"title": "Search keywords",
"type": "array",
"description": "Products to search for, one per line (e.g. jordan 1, dunk low panda, a brand, a model, a SKU/style ID like DD1391-100). Each keyword becomes one StockX search.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "StockX URLs to scrape directly: a product page (returns full product details and the live market), a search results page, or a category / filtered browse page (paginated automatically).",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"currency": {
"title": "Currency",
"enum": [
"USD",
"EUR",
"GBP",
"CAD",
"AUD",
"JPY",
"CHF",
"HKD",
"KRW",
"SGD",
"MXN",
"NZD"
],
"type": "string",
"description": "Currency for every price in the output.",
"default": "USD"
},
"country": {
"title": "Country / market",
"type": "string",
"description": "Two-letter country code of the market to read prices from (e.g. US, GB, FR, DE, JP). Ask and bid counts and availability are market-specific.",
"default": "US"
},
"sort": {
"title": "Sort order",
"enum": [
"relevance",
"featured",
"most-active",
"release_date",
"lowest_ask",
"highest_bid",
"last_sale",
"number_of_asks",
"number_of_bids"
],
"type": "string",
"description": "How to order search results before the cap is applied.",
"default": "relevance"
},
"gender": {
"title": "Gender",
"enum": [
"",
"men",
"women",
"youth",
"infant",
"preschool",
"toddler",
"unisex"
],
"type": "string",
"description": "Keep only products of this gender.",
"default": ""
},
"belowRetail": {
"title": "Below retail only",
"type": "boolean",
"description": "Keep only products whose lowest ask is under their original retail price (deals).",
"default": false
},
"minPrice": {
"title": "Minimum lowest ask",
"minimum": 1,
"type": "integer",
"description": "Keep only products whose lowest ask is at or above this value (in the selected currency)."
},
"maxPrice": {
"title": "Maximum lowest ask",
"minimum": 1,
"type": "integer",
"description": "Keep only products whose lowest ask is at or below this value (in the selected currency)."
},
"maxItems": {
"title": "Max products (total)",
"minimum": 1,
"type": "integer",
"description": "Hard cap on the total number of products across all searches and URLs. You pay per result, so this is also your cost cap.",
"default": 100
},
"maxItemsPerQuery": {
"title": "Max products per search",
"minimum": 1,
"type": "integer",
"description": "Optional cap per individual keyword or URL. Leave empty to only use the total cap."
},
"includeProductDetails": {
"title": "Include full product details",
"type": "boolean",
"description": "Attach full product data: every size with its size conversions (US, UK, EU, CM, KR) and GTIN/UPC codes, style ID, description, 360 images, categories and SEO. Adds one request per product.",
"default": false
},
"includeSizeMarket": {
"title": "Include per-size market",
"type": "boolean",
"description": "Attach the full size run with each size's own lowest ask, highest bid, number of asks and bids, last sale and 90-day sales. This is the core reseller data. Adds requests per product.",
"default": false
},
"includeColorFamily": {
"title": "Include color family",
"type": "boolean",
"description": "Attach the other colorways in the same product family, with their markets.",
"default": false
},
"sessionCookies": {
"title": "Account cookies (optional)",
"type": "array",
"description": "Optional. Paste your StockX account cookies (as a browser cookie export array, or name=value lines) to run as your logged-in account, which can unlock account-specific access. Leave empty to scrape the public market anonymously."
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy settings. Residential proxies are recommended for reliable runs.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
},
"verbose": {
"title": "Verbose logging",
"type": "boolean",
"description": "Log progress details for every search.",
"default": true
}
}
},
"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
}
}
}
}
}
}
}
}
}
}