{ "openapi": "3.0.1", "info": { "title": "ASOS Scraper", "description": "Scrape ASOS products and categories from all 12 storefronts, each in its own currency. Get prices, stock per size, variants, EAN barcodes, images, catwalk videos, ratings, reviews and saved counts, or every menu category from one storefront URL.", "version": "1.0", "x-build-id": "GbcG8qMTy4cfPMftP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/autofacts~asos/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-autofacts-asos", "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/autofacts~asos/runs": { "post": { "operationId": "runs-sync-autofacts-asos", "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/autofacts~asos/run-sync": { "post": { "operationId": "run-sync-autofacts-asos", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "ASOS start urls", "type": "array", "description": "Start URLs of ASOS to start the actor. A storefront (https://www.asos.com/, https://www.asos.com/us/) or department (/men/, /women/) URL scrapes every category in that storefront's menu. Category (/cat/?cid=), search (/search/?q=), product group (/grp/) and product (/prd/) URLs are all supported, from any storefront. Add &page=N to a category or search URL to start from that page.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "withCategoryProducts": { "title": "Scrape products of every menu category", "type": "boolean", "description": "For storefront and department start URLs: besides one record per category (title, menu paths, product count, facets), also scrape every product in those categories, each product once. Off: categories only, one request per category.", "default": false }, "withReviews": { "title": "Fetch reviews", "type": "boolean", "description": "Fetch rating statistics (distribution, recommendations, fit/quality/comfort averages, AI review summary) and the latest reviews for each product. One extra request per product.", "default": true }, "maxReviewsPerProduct": { "title": "Reviews per product", "minimum": 0, "maximum": 100, "type": "integer", "description": "How many of the latest reviews to include per product when reviews are fetched (0 keeps only the statistics).", "default": 10 }, "withSavedCount": { "title": "Fetch saved-for-later count", "type": "boolean", "description": "Fetch how many shoppers saved each product in the last 30 days (stats.lovesCount). One extra request per product.", "default": true }, "withOtherColours": { "title": "Fetch other colours", "type": "boolean", "description": "List the other colours of the same style, with price and stock (relatedProducts). One extra request per product.", "default": true }, "maxRequestsPerCrawl": { "title": "Max Requests per Crawl", "minimum": 0, "type": "integer", "description": "Maximum number of pages (storefront menus, listing pages, products, groups) the crawler processes, 0 to ignore.", "default": 0 }, "maxConcurrency": { "title": "Actor max concurrency", "minimum": 2, "maximum": 500, "type": "integer", "description": "Actor running max concurrency, which helps you to not getting blocked.", "default": 20 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your crawler." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }