# ASOS Product Scraper | Fashion Prices & SKUs (`lentic_clockss/asos-scraper`) Actor Scrape ASOS.com fashion products — keyword search, category PLP & PDP. Extract prices, brands, colourWayId, sizes, images across global markets. Export Excel/CSV/JSON. Unofficial. - **URL**: https://apify.com/lentic\_clockss/asos-scraper.md - **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community) - **Categories:** E-commerce, Automation, Lead generation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ASOS Product Scraper | Fashion Prices, Search & Categories **Scrape ASOS.com product listings, keyword search results, and product detail pages — then download structured fashion data as Excel, CSV, or JSON.** Use this Actor as a practical **ASOS product data API** for price monitoring, assortment research, and competitor tracking. Pick a browse country, choose a mode (category, search, or PDP), and get Dataset rows with prices, brands, colour ways, sizes, images, and product URLs. - Scrape **ASOS search**, **category PLP** (Sale / New in / Face + Body / Clothing / Shoes / …), and **product detail pages** - Cover **global ASOS markets** via `browseCountry` (UK, US, EU, AU, Asia, ROW, and shipping destinations) - Extract **price, brand, colourWayId, product code, sizes, images, sale flags**, and optional PDP enrich - Filter with ASOS **`refine` / `sort` / `currentPriceRange`**, paginate with `page` / `maxPages` - Export to **Excel / CSV / JSON**, or connect Make, n8n, Zapier, Python, or the Apify API - **Pay per event** — Actor start + each Dataset result; **platform usage is included** (you do not pay separate Apify compute on top) > **Unofficial tool.** This Actor is not affiliated with, endorsed by, or sponsored by ASOS. It collects publicly reachable shopping surfaces and does **not** add items to bag, checkout, or access private accounts. **Reviews** are out of scope. --- ### What does the ASOS Product Scraper do? ASOS Product Scraper lets you **extract structured fashion product data from ASOS** without running your own anti-bot browser fleet. Give it a keyword, category `cid` / bucket, or product id / URL, then start a run. Under the hood, the Actor: 1. Validates your input (mode, browse country, query / cid / product id, filters) 2. Enforces free-tier caps when you are on a free Apify plan 3. Calls a managed Cloud Run worker (`asos-com`) that opens ASOS with residential egress 4. Parses guest-visible PLP / Search `products[]` (with DOM fallback) and PDP `data-testid` fields 5. Pushes Dataset rows ready for Excel / CSV / JSON export 6. Writes `RUN_SUMMARY` (and `ERROR_SUMMARY` on failure) to the key-value store You run it like any other Apify Actor — schedule it, call it from the API, or plug it into automations. --- ### What ASOS data can I extract? | Data | Keyword search | Category PLP | Product detail | Taxonomy | | --- | :---: | :---: | :---: | :---: | | Product id / colourWayId | ✅ | ✅ | ✅ | — | | Title / brand | ✅ | ✅ | ✅ | — | | Price / currency / sale flags | ✅ | ✅ | ✅* | — | | Image URLs | ✅ | ✅ | — | — | | Product URL | ✅ | ✅ | ✅ | — | | Sizes / colour ways | — | —* | ✅ | — | | Related products | — | —* | ✅ | — | | Category cid / slug / bucket | — | ✅ | — | ✅ | | Browse country | ✅ | ✅ | ✅ | ✅ | \*Enable `enrichDetails` and/or `expandColours` on listing modes. Bag, Checkout, Sign-in, and Reviews are **not** scraped. --- ### Why scrape ASOS? ASOS is one of the largest online fashion retailers, with deep catalogs across clothing, shoes, accessories, Face + Body, and sale. Teams scrape ASOS for **price monitoring**, **competitor analysis**, and **trend tracking**: - Monitor **fashion prices, sale prices, and promotions** across countries and currencies - Track **Sale / New in / category assortments** for retail buyers and brand teams - Capture **SKU / colourWayId + size matrices**, images, and materials-ready fields for listing enrichment - Feed BI dashboards, pricing tools, or AI agents with structured apparel rows Compared with single-mode ASOS Actors that only accept a search URL **or** only PDP links, this Actor covers **keyword search + category PLP + taxonomy + product detail**, with **filters, multi-market cookies, and optional colour-way expansion** in one input surface. --- ### How to scrape ASOS products (no code required) 1. Create a free [Apify](https://apify.com/) account 2. Open [ASOS Product Scraper](https://apify.com/lentic_clockss/asos-scraper) 3. Choose a **mode**: `keywordSearch`, `categorySearch`, `productDetail`, or `categories` 4. Set **browseCountry** (e.g. `GB`, `US`, `FR`, `DE`, `AE`, `JP`, or `ROW`) 5. Enter a **query** (search), **cid** / **bucket** (category), or **productId** / **productUrl** (PDP) 6. *(Optional)* Set `refine`, `sort`, `maxResults`, `enrichDetails`, or `expandColours` 7. Click **Start** and download the Dataset as JSON, CSV, Excel, or JSONL Start with `maxResults: 5–10` to verify the query, then scale up. --- ### How much does it cost to scrape ASOS? This Actor uses **pay-per-event** pricing. You are charged for: | Event | Price | | --- | --- | | Actor Start (`apify-actor-start`) | **$0.005** per start | | Result (`apify-default-dataset-item`) | **$3.00 / 1,000** results (**$0.003** each) | **Platform usage costs are included** — you do **not** pay separate Apify compute/proxy usage for this Actor on top of the event prices above (**User pays platform usage costs = No**). #### Example cost estimates | Results collected | Approx. event cost* | | --- | ---: | | 100 | ~$0.31 | | 1,000 | ~$3.01 | | 10,000 | ~$30.01 | \*Assumes one Actor start at default memory billing for start events, plus `$0.003` per Dataset item. Exact start billing can scale with allocated memory (one start event per GB, minimum one). #### Free plan limits On a **free Apify plan**, this Actor enforces developer limits of **10 runs** and **200 results per run**. Upgrade to a paid Apify plan for unlimited runs (event prices still apply). --- ### Input examples #### Keyword search (UK) ```json { "mode": "keywordSearch", "browseCountry": "GB", "query": "linen shirt", "maxResults": 40, "maxPages": 2 } ```` #### Category / Sale PLP ```json { "mode": "categorySearch", "browseCountry": "US", "gender": "women", "bucket": "sale", "maxResults": 50, "maxPages": 3 } ``` #### Category by cid + filter ```json { "mode": "categorySearch", "browseCountry": "DE", "gender": "women", "categorySlug": "dresses", "cid": "8799", "sort": "pricedasc", "maxResults": 30 } ``` #### Product detail ```json { "mode": "productDetail", "browseCountry": "HK", "productId": "211372645", "colourWayId": "211372655" } ``` #### Category taxonomy ```json { "mode": "categories", "gender": "women", "bucket": "new_in" } ``` *** ### Output example ```json { "id": "204402083", "colourWayId": "204402138", "title": "ONLY & SONS linen mix long sleeve slim fit shirt in white", "brandName": "ONLY & SONS", "price": 32, "currency": "GBP", "url": "https://www.asos.com/only-sons/.../prd/204402083#colourWayId-204402138", "browseCountry": "GB", "mode": "keywordSearch", "source": "asos" } ``` *** ### Modes and coverage | Mode | What it scrapes | | --- | --- | | `keywordSearch` | `/search/?q=` listings | | `categorySearch` | `/…/cat/?cid=` PLP (Sale, New in, Face + Body, clothing, shoes, …) | | `productDetail` | `/prd/{id}` price, colour, sizes, colourWays, related | | `categories` | Local taxonomy of cid / slug / bucket (no browser) | **Markets:** any ISO-2 from the ASOS country selector (+ `ROW`), with optional `currency`. **Waived:** Bag, Checkout, Sign-in, Reviews. *** ### Is it legal to scrape ASOS? Scraping publicly available product listing data is commonly done for research, price monitoring, and analytics. This Actor only targets guest-visible shopping pages and does **not** bypass logins or automate purchases. You are responsible for complying with ASOS terms, local laws, and your own data-use policies. Prefer respectful `maxResults` / scheduling. *** ### FAQ #### Can I scrape ASOS by category and by keyword? Yes. Use `categorySearch` with `cid` or `bucket` (e.g. `sale`, `new_in`, `face_body`), or `keywordSearch` with `query`. #### Does it support multiple countries and currencies? Yes. Set `browseCountry` (ISO-2 or `ROW`) and optionally override `currency`. The worker sets ASOS session cookies accordingly. #### Can I get sizes and colour ways? Enable `productDetail`, or set `enrichDetails` / `expandColours` on listing modes to pull PDP size and colourWay data. #### Do I need my own proxies? No. With `WORKER_PROVIDES_PROXY=1` (default), the managed worker supplies residential egress. You do not mint Apify RESIDENTIAL proxies in the Actor. #### Why are some listing fields thinner on certain markets? Some markets intermittently omit embedded `products[]`; the worker falls back to DOM tiles so you still get id / URL / colourWayId / price signals. *** ### Integrations - [Apify API](https://docs.apify.com/api/v2) / `apify call lentic_clockss/asos-scraper` - Make, Zapier, n8n webhooks - Python / Node SDKs (`apify-client`) - Schedules for recurring price or assortment checks Default memory: **1024 MB**. Standby Live View is enabled for health / OpenAPI exploration. *** ### Support Open an issue on the Actor page or contact the developer via Apify. Include your **run id**, input JSON, and whether you used search, category, or PDP mode. # Actor input Schema ## `mode` (type: `string`): categorySearch / keywordSearch / productDetail / categories (taxonomy listing). ## `browseCountry` (type: `string`): ISO-2 from ASOS country selector (or ROW). Examples: GB, US, PL, AE, JP. ## `currency` (type: `string`): Optional browseCurrency override (e.g. GBP, USD, PLN). ## `gender` (type: `string`): women or men — category / taxonomy. ## `bucket` (type: `string`): Shortcut: sale, new\_in, face\_body, clothing, shoes, accessories, activewear, brands, outlet. ## `categorySlug` (type: `string`): URL slug, e.g. dresses or sale. ## `categoryPath` (type: `string`): Full path prefix e.g. women/sale or women/new-in/new-in-clothing. ## `cid` (type: `string`): ASOS category cid. ## `query` (type: `string`): Keyword for keywordSearch. ## `keyword` (type: `string`): Alias of query. ## `refine` (type: `string`): ASOS refine= query, e.g. attribute\_10992:61379 ## `sort` (type: `string`): ASOS sort value: freshness, pricedasc, priceddesc, favourite, trending. ## `currentPriceRange` (type: `string`): ASOS currentpricerange param. ## `productId` (type: `string`): Product ID ## `colourWayId` (type: `string`): Colour way ID ## `productUrl` (type: `string`): Product URL ## `maxPages` (type: `integer`): Max pages ## `maxResults` (type: `integer`): Max results ## `enrichDetails` (type: `boolean`): Enrich with PDP ## `expandColours` (type: `boolean`): For listings, expand alternate colourWayId rows via PDP. ## `includeRelated` (type: `boolean`): Include related products ## `workerBaseUrl` (type: `string`): Worker base URL override ## Actor input object example ```json { "mode": "keywordSearch", "browseCountry": "GB", "gender": "women", "maxPages": 3, "maxResults": 40, "enrichDetails": false, "expandColours": false, "includeRelated": true } ``` # Actor output Schema ## `results` (type: `string`): Normalized Walmart product / category rows from the default dataset. ## `runSummary` (type: `string`): Structured summary record stored in the default key-value store. ## `inputEcho` (type: `string`): Normalized input saved at run start. ## `errorSummary` (type: `string`): Present when a failed run stores structured terminal error information. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("lentic_clockss/asos-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("lentic_clockss/asos-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call lentic_clockss/asos-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=lentic_clockss/asos-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ASOS Product Scraper | Fashion Prices & SKUs", "description": "Scrape ASOS.com fashion products — keyword search, category PLP & PDP. Extract prices, brands, colourWayId, sizes, images across global markets. Export Excel/CSV/JSON. Unofficial.", "version": "0.1", "x-build-id": "DISDjWQSFCrP0pw6w" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~asos-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-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/lentic_clockss~asos-scraper/runs": { "post": { "operationId": "runs-sync-lentic_clockss-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/lentic_clockss~asos-scraper/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-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": [ "categorySearch", "keywordSearch", "productDetail", "categories" ], "type": "string", "description": "categorySearch / keywordSearch / productDetail / categories (taxonomy listing).", "default": "keywordSearch" }, "browseCountry": { "title": "Browse country", "type": "string", "description": "ISO-2 from ASOS country selector (or ROW). Examples: GB, US, PL, AE, JP.", "default": "GB" }, "currency": { "title": "Currency", "type": "string", "description": "Optional browseCurrency override (e.g. GBP, USD, PLN)." }, "gender": { "title": "Gender", "enum": [ "women", "men" ], "type": "string", "description": "women or men — category / taxonomy.", "default": "women" }, "bucket": { "title": "Category bucket", "enum": [ "sale", "new_in", "face_body", "clothing", "shoes", "accessories", "activewear", "brands", "outlet", "other" ], "type": "string", "description": "Shortcut: sale, new_in, face_body, clothing, shoes, accessories, activewear, brands, outlet." }, "categorySlug": { "title": "Category slug", "type": "string", "description": "URL slug, e.g. dresses or sale." }, "categoryPath": { "title": "Category path", "type": "string", "description": "Full path prefix e.g. women/sale or women/new-in/new-in-clothing." }, "cid": { "title": "Category ID (cid)", "type": "string", "description": "ASOS category cid." }, "query": { "title": "Search query", "type": "string", "description": "Keyword for keywordSearch." }, "keyword": { "title": "Keyword (alias)", "type": "string", "description": "Alias of query." }, "refine": { "title": "Refine filter", "type": "string", "description": "ASOS refine= query, e.g. attribute_10992:61379" }, "sort": { "title": "Sort", "enum": [ "freshness", "pricedasc", "priceddesc", "favourite", "trending" ], "type": "string", "description": "ASOS sort value: freshness, pricedasc, priceddesc, favourite, trending." }, "currentPriceRange": { "title": "Price range", "type": "string", "description": "ASOS currentpricerange param." }, "productId": { "title": "Product ID", "type": "string", "description": "Product ID" }, "colourWayId": { "title": "Colour way ID", "type": "string", "description": "Colour way ID" }, "productUrl": { "title": "Product URL", "type": "string", "description": "Product URL" }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 50, "type": "integer", "description": "Max pages", "default": 3 }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Max results", "default": 40 }, "enrichDetails": { "title": "Enrich with PDP", "type": "boolean", "description": "Enrich with PDP", "default": false }, "expandColours": { "title": "Expand colourWays", "type": "boolean", "description": "For listings, expand alternate colourWayId rows via PDP.", "default": false }, "includeRelated": { "title": "Include related products", "type": "boolean", "description": "Include related products", "default": true }, "workerBaseUrl": { "title": "Worker base URL override", "type": "string", "description": "Worker base URL override" } } }, "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 } } } } } } } } } } ```