{ "openapi": "3.0.1", "info": { "title": "ASOS Sale Watch: Products & Markdowns by Country", "description": "ASOS products from 11 country stores as flat rows: name, brand, price, price before the markdown, discount percent, lowest price in the last 30 days, colour, photos, URL. Search any terms; filter to sale items, a minimum discount, newest or price order.", "version": "0.1", "x-build-id": "H8C2jIG3LkoSgNMaB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/superslowsloth~asos-products/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-superslowsloth-asos-products", "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/superslowsloth~asos-products/runs": { "post": { "operationId": "runs-sync-superslowsloth-asos-products", "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/superslowsloth~asos-products/run-sync": { "post": { "operationId": "run-sync-superslowsloth-asos-products", "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": [ "queries" ], "properties": { "store": { "title": "ASOS store", "enum": [ "us", "com", "au", "de", "fr", "es", "it", "nl", "se", "dk", "pl" ], "type": "string", "description": "Which ASOS country store to search. Each store has its own currency, language and prices: United States (USD), United Kingdom (GBP), Australia (AUD), Germany, France, Spain, Italy and Netherlands (EUR), Sweden (SEK), Denmark (DKK) and Poland (PLN). Only stores that returned products when measured on 2026-10-12 are listed.", "default": "us" }, "queries": { "title": "Search terms", "type": "array", "description": "What you would type into the ASOS search box, one term per line (for example jeans, white trainers or Levi's 501). Each term is searched and read separately; a product that two terms both find is returned once, under the first. ASOS's own search matches the term in the chosen store (on the Italy store both jeans and the Italian profumo found products, measured 2026-10-12).", "items": { "type": "string" } }, "onlyOnSale": { "title": "Only products on sale", "type": "boolean", "description": "Keep only products ASOS currently marks down (its own Sale filter). Each row then carries the price before the markdown and the discount percent. With this off, sale and full-price products come back mixed, in ASOS's own ranking.", "default": false }, "minDiscount": { "title": "Minimum discount", "enum": [ "0", "20", "30", "40", "50", "60" ], "type": "string", "description": "Keep only products marked down by at least this much, using ASOS's own Discount % bands (20-30%, 30-40%, ... 60% or more). Choosing anything but 'No minimum' also turns on 'Only products on sale'. ASOS applies the filter itself, so Max products counts matching products only.", "default": "0" }, "sort": { "title": "Sort by", "enum": [ "relevance", "newest", "price_low", "price_high" ], "type": "string", "description": "Order of the results. 'ASOS ranking' is the order the ASOS search page shows by default. Newest first, cheapest first and most expensive first are ASOS's own sort options. With a Max products limit, the order decides which products you get.", "default": "relevance" }, "maxItems": { "title": "Max products per search term", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Read at most this many products for each search term. ASOS serves up to 200 per request but only the first 1,000 results of any one search, however many it reports finding (5,919 for jeans in the US store), so 1,000 is the limit. To reach beyond it, narrow the search: another term, the sale filter or a minimum discount.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy (automatic datacenter exits) is the default. ASOS's edge refuses about two requests in five from the datacenter pool with an Access Denied page; the actor retries each refused page from a fresh address, which is what the proxy is for.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }