{ "openapi": "3.0.1", "info": { "title": "ASOS Scraper", "description": "Scrape ASOS (Europe's largest online fashion marketplace) with search by keyword, browse by category, fetch by product ID or URL, or check live stock and pricing. Returns names, brands, prices, sizes, images, descriptions, and stock per size across 10 markets (US, UK, DE, FR, IT, ES, AU, NL, SE, RU)", "version": "1.0", "x-build-id": "jLpDBevPLPcIDgdkw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~asos-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-asos-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~asos-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-asos-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~asos-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-asos-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", "byProductIds", "byUrls", "stockCheck" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text query (mode=search). Example: `dress`, `levis jeans`, `nike sneakers`.", "default": "dress" }, "store": { "title": "Store / market", "enum": [ "US", "GB", "FR", "DE", "IT", "ES", "AU", "NL", "SE", "RU" ], "type": "string", "description": "ASOS country store. Currency defaults to the store's local currency unless overridden.", "default": "US" }, "currency": { "title": "Currency", "enum": [ "", "USD", "GBP", "EUR", "AUD", "SEK", "RUB", "CAD" ], "type": "string", "description": "Override the store's default currency. Leave blank to use the store default.", "default": "" }, "gender": { "title": "Gender", "enum": [ "", "women", "men" ], "type": "string", "description": "Restrict to the women's or men's edit (search/byCategory).", "default": "" }, "category": { "title": "Curated category (mode=byCategory)", "enum": [ "", "women_new_in_clothing", "women_dresses", "women_tops", "women_shirts", "women_shoes", "women_jeans", "women_accessories", "women_activewear", "men_new_in_clothing", "men_tops", "men_shirts", "men_shoes", "men_jeans", "men_accessories" ], "type": "string", "description": "Pick one of ASOS's most-browsed top-level categories. Use `categoryId` for any other ASOS category ID.", "default": "" }, "categoryId": { "title": "Category ID (advanced override)", "minimum": 1, "maximum": 999999, "type": "integer", "description": "Numeric ASOS category ID (e.g. 8799 = Dresses). Overrides `category` if set." }, "productIds": { "title": "Product IDs (mode=byProductIds, stockCheck)", "type": "array", "description": "Numeric ASOS product IDs (5–12 digits). Example: `210484705`.", "default": [], "items": { "type": "string" } }, "productUrls": { "title": "Product URLs (mode=byUrls)", "type": "array", "description": "Full ASOS product URLs (must contain `/prd/`).", "default": [], "items": { "type": "string" } }, "brandIds": { "title": "Brand IDs", "type": "array", "description": "ASOS numeric brand IDs (e.g. `53` = ASOS DESIGN, `13511` = ASOS Curve, `16631` = ASOS Luxe, `27869` = ASOS Petite). Inspect the `Brand` facet of any search response for the full list.", "default": [], "items": { "type": "string" } }, "colourIds": { "title": "Colour IDs", "type": "array", "description": "ASOS numeric colour IDs (e.g. `4` = Black, `10` = Brown, `17` = Multi, `2` = White, `7` = Green, `6` = Blue, `8` = Pink, `5` = Red, `3` = Grey, `11` = Beige).", "default": [], "items": { "type": "string" } }, "sizeIds": { "title": "Size IDs", "type": "array", "description": "ASOS numeric size IDs (e.g. `5131` = 2XS, `5179` = XS, `5180` = S, `5181` = M, `5182` = L, `5183` = XL). Inspect the `size` facet for the full mapping per category.", "default": [], "items": { "type": "string" } }, "sortBy": { "title": "Sort", "enum": [ "", "freshness", "priceasc", "pricedesc" ], "type": "string", "description": "Result ordering.", "default": "" }, "minPrice": { "title": "Min price", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Filter out products below this price (in the active currency)." }, "maxPrice": { "title": "Max price", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Filter out products above this price (in the active currency)." }, "onSaleOnly": { "title": "On sale only", "type": "boolean", "description": "Restrict to marked-down items.", "default": false }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "Drop out-of-stock products (most useful with mode=byProductIds / byUrls; search hides OOS by default).", "default": false }, "containsKeyword": { "title": "Contains keyword", "type": "string", "description": "Client-side substring filter applied to name / brand / colour / description." }, "includeDetails": { "title": "Include full product details", "type": "boolean", "description": "For search / category modes, also fetch each product's PDP HTML to get sizes, stock, description, etc. Slower but richer. Already on for byProductIds / byUrls.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on emitted records.", "default": 50 } } }, "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 } } } } } } } } } }