ASOS Actor

ASOS Actor crawls ASOS categories and products — prices, stock per size, variants, images and videos, ratings, reviews and more — from storefront, department, category, search, product-group and product URLs in any ASOS storefront.

🎯 Features

1. 🔗 Category, search, product-group and product URLs, from any storefront (www.asos.com, /us, /fr, /de, /au, ...).
2. 🗂️ Every category of a storefront's menu from just its home page (https://www.asos.com/) or a department (/men/, /women/): one record per category with its menu paths, product count and refinement facets — and optionally every product in them.
3. 🌍 Each storefront is read in its own store, currency, language and size schema — a /us/ URL gives USD prices and US sizes.
4. 📦 Per-variant price and stock (in stock / low in stock / out of stock), SKU and EAN barcode.
5. 💰 Prices with previous price, RRP, 30-day lowest price and markdown / outlet flags.
6. 🖼️ Images (model shots, flat-lays, spin sets, swatches) and catwalk videos, each linked to its colour.
7. ⭐ Rating statistics, fit/quality/comfort averages, the AI review summary and the latest reviews.
8. ❤️ Saved-for-later count, the other colours of the same style, localised URLs for every ASOS language.
9. 👔 Product groups (co-ords, suits) as one record with every piece as a full product in subProducts.

💡 Prices are integer minor units (pence, cents): £90.00 is 9000.

📋 Input Parameters

Field	Type	Description
startUrls	Array	ASOS URLs to start from. A storefront (https://www.asos.com/, https://www.asos.com/us/) or department (/men/, /women/) URL means every category in that storefront's menu. Category (/cat/?cid=), search (/search/?q=), product group (/grp/<id>) and product (/prd/<id>) URLs are supported from any storefront. Add &page=N to a category or search URL to start from that page.
withCategoryProducts	Boolean	For storefront and department URLs, also scrape every product of every menu category (each product once). Default false: category records only.
withReviews	Boolean	Fetch rating statistics and the latest reviews. Default true.
maxReviewsPerProduct	Integer	Latest reviews to include per product, 0–100. Default 10; 0 keeps only the statistics.
withSavedCount	Boolean	Fetch the saved-for-later count of the last 30 days (stats.lovesCount). Default true.
withOtherColours	Boolean	List the other colours of the same style (relatedProducts). Default true.
maxRequestsPerCrawl	Integer	Maximum pages (storefront menus, listing pages, products, groups) to process, 0 for no limit. Default 0.
maxConcurrency	Integer	Actor running max concurrency. Default 20.
proxy	Object	Proxies to use. ⚠️ Small runs work without one, but ASOS rate-limits a single IP after a few thousand API calls (403), so use RESIDENTIAL for category-wide or storefront-wide crawls — sessions then rotate IPs on a block.

🧪 Example:

{
  "startUrls": [
    { "url": "https://www.asos.com/women/dresses/cat/?cid=8799" },
    { "url": "https://www.asos.com/us/search/?q=sunglasses" },
    { "url": "https://www.asos.com/adidas-originals/adidas-originals-handball-spezial-gum-sole-trainers-in-brown-and-white/prd/205774480" }
  ],
  "maxReviewsPerProduct": 10,
  "maxConcurrency": 20
}

🗂️ Every category of the UK and US women's menus, with their products:

{
  "startUrls": [
    { "url": "https://www.asos.com/women/" },
    { "url": "https://www.asos.com/us/women/" }
  ],
  "withCategoryProducts": true,
  "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}

🔗 Supported Pages

Page	Example
🏬 Storefront (all categories)	https://www.asos.com/, https://www.asos.com/us/
🧭 Department (its categories)	https://www.asos.com/women/, https://www.asos.com/fr/men/
📁 Category	https://www.asos.com/women/dresses/cat/?cid=8799
🏷️ Brand / sale	https://www.asos.com/men/a-to-z-of-brands/salomon/cat/?cid=51207
🔍 Search	https://www.asos.com/search/?q=levis+501
👔 Product group	https://www.asos.com/grp/77157
🛍️ Product	https://www.asos.com/prd/205774480 or the full slugged URL
🌍 Any storefront	https://www.asos.com/us/..., https://www.asos.com/fr/...

📤 Data storage

Products and categories are stored in the default dataset. A product record has source; a category record has handle and productsCount instead (the Apify Console shows them in separate views).

🛍️ Product

Every 1.x field is still emitted with the same name and meaning; 2.0 adds fields (see CHANGELOG.md). Arrays and long texts are shortened below.

{
  "source": {
    "id": "205774480",
    "crawlUrl": "https://www.asos.com/adidas-originals/adidas-originals-handball-spezial-gum-sole-trainers-in-brown-and-white/prd/205774480",
    "canonicalUrl": "https://www.asos.com/adidas-originals/adidas-originals-handball-spezial-gum-sole-trainers-in-brown-and-white/prd/205774480",
    "retailer": "ASOS",
    "language": "en-GB",
    "currency": "GBP",
    "store": "COM",
    "country": "GB",
    "sizeSchema": "UK"
  },
  "title": "adidas Originals Handball Spezial gum sole trainers in brown and white",
  "description": {
    "detail": "<a href=\"https://www.asos.com/women/shoes/cat/?cid=4172\"><strong>Shoes</strong></a> by adidas Originals<br><ul><li>Low-profile design</li><li>Lace-up fastening</li><li>Padded cu...",
    "sizeAndFit": "",
    "careInfo": "Wipe clean with a soft dry cloth",
    "aboutMe": "Soft, textured upper<br><br>Sole: 100% Rubber, Upper: 50% Leather, 50% Textile.",
    "brand": "<a href=\"https://www.asos.com/men/a-to-z-of-brands/adidas/cat/?cid=7113\"><strong>adidas Originals</strong></a> needs no introduction. The brand’s famous 3-Stripes can be seen on..."
  },
  "brand": "adidas Originals",
  "categories": [
    "Unisex",
    "Trainers"
  ],
  "medias": [
    {
      "type": "Image",
      "url": "https://images.asos-media.com/products/adidas-originals-handball-spezial-gum-sole-trainers-in-brown-and-white/205774480-1-multi",
      "isDefault": true,
      "index": 0,
      "optionId": "205774481",
      "variantIds": [
        "206675555",
        "205774490"
      ],
      "role": "product",
      "alt": "MULTI"
    },
    {
      "type": "Image",
      "url": "https://images.asos-media.com/products/adidas-originals-handball-spezial-gum-sole-trainers-in-brown-and-white/205774480-2",
      "isDefault": false,
      "index": 1,
      "role": "product",
      "alt": ""
    }
  ],
  "variants": [
    {
      "id": "206675555",
      "sku": "135912910",
      "title": "adidas Originals Handball Spezial gum sole trainers in brown and white",
      "options": [
        "205774481",
        "596146"
      ],
      "price": {
        "current": 9000,
        "previous": 9000,
        "stockStatus": "InStock",
        "currency": "GBP",
        "currentText": "£90.00",
        "previousText": "£90.00",
        "isMarkedDown": false,
        "isOutletPrice": false,
        "priceStartUTC": 1790132137000,
        "isRestockingSoon": false
      },
      "gtin": "4066765223623",
      "extraInfo": {
        "colour": "MULTI",
        "brandSize": "UK 3",
        "displaySizeText": "UK 3",
        "sizeOrder": 5,
        "refinementSizeId": 3255,
        "isAvailable": true,
        "isPrimary": true,
        "isProp65Risk": true,
        "countryOfManufacture": "ID",
        "stockLastUpdatedUTC": 1786044255681,
        "showShippedByMessage": true,
        "hasStockRecord": true
      }
    },
    {
      "id": "205774490",
      "sku": "133694638",
      "title": "adidas Originals Handball Spezial gum sole trainers in brown and white",
      "options": [
        "205774481",
        "596125"
      ],
      "price": {
        "current": 9000,
        "previous": 9000,
        "stockStatus": "InStock",
        "currency": "GBP",
        "currentText": "£90.00",
        "previousText": "£90.00",
        "isMarkedDown": false,
        "isOutletPrice": false,
        "priceStartUTC": 1790132601000,
        "isRestockingSoon": false
      },
      "gtin": "4066765223630",
      "extraInfo": {
        "colour": "MULTI",
        "brandSize": "UK 3.5",
        "displaySizeText": "UK 3.5",
        "sizeOrder": 6,
        "refinementSizeId": 6397,
        "isAvailable": true,
        "isPrimary": true,
        "isProp65Risk": true,
        "countryOfManufacture": "ID",
        "stockLastUpdatedUTC": 1786044256092,
        "showShippedByMessage": true,
        "hasStockRecord": true
      }
    }
  ],
  "options": [
    {
      "type": "Colour",
      "values": [
        {
          "id": "205774481",
          "name": "MULTI",
          "index": 0
        }
      ]
    },
    {
      "type": "Size",
      "values": [
        {
          "id": "596146",
          "name": "UK 3",
          "index": 5
        },
        {
          "id": "596125",
          "name": "UK 3.5",
          "index": 6
        }
      ]
    }
  ],
  "price": {
    "current": 9000,
    "previous": 9000,
    "stockStatus": "InStock",
    "currency": "GBP",
    "currentText": "£90.00",
    "previousText": "£90.00",
    "isMarkedDown": false,
    "isOutletPrice": false,
    "priceStartUTC": 1789379805000,
    "isRestockingSoon": false
  },
  "stats": {
    "rating": 4.8,
    "starRating": 5,
    "reviewCount": 4016,
    "ratingRange": 5,
    "recommendedCount": 3709,
    "notRecommendedCount": 88,
    "percentageRecommended": 98,
    "ratingsOnlyReviewCount": 57,
    "ratingDistribution": [
      {
        "rating": 5,
        "count": 3639
      },
      {
        "rating": 4,
        "count": 245
      }
    ],
    "secondaryRatings": [
      {
        "id": "Size",
        "label": "Size",
        "average": 3.0375187593796897,
        "range": 5,
        "minLabel": "Runs Small",
        "maxLabel": "Runs Large"
      },
      {
        "id": "Comfort_1",
        "label": "Comfort",
        "average": 4.4145962732919255,
        "range": 5,
        "minLabel": "Uncomfortable",
        "maxLabel": "Comfortable"
      }
    ],
    "reviewsSummary": "Customers overwhelmingly praise these trainers for exceptional comfort and stylish design. Most describe them as incredibly comfortable for all-day wear, wit...",
    "lovesCount": 24983,
    "lovesCountWindowHours": 720
  },
  "reviews": [
    {
      "id": "1230931506",
      "rating": 5,
      "ratingRange": 5,
      "title": "Gorgeous, on-trend shoes",
      "text": "Gorgeous trainers, love the colour and the style goes with everything from dresses to jeans. Really comfy and the additional laces were a nice surprise. High...",
      "author": "Charli",
      "locale": "en_GB",
      "isRecommended": true,
      "isRatingsOnly": false,
      "isSyndicated": false,
      "submittedUTC": 1790276774000,
      "colour": "MULTI",
      "badges": [
        "verifiedPurchaser"
      ],
      "secondaryRatings": [
        {
          "id": "Size",
          "label": "Size",
          "value": 3,
          "valueLabel": "True to Size",
          "range": 5
        },
        {
          "id": "Comfort_1",
          "label": "Comfort",
          "value": 5,
          "valueLabel": "Comfortable",
          "range": 5
        }
      ]
    },
    {
      "id": "185065672",
      "rating": 5,
      "ratingRange": 5,
      "title": "I love the fact that they comfortable to wear",
      "text": "They can be worn with both smart and everyday outfits, overall a great pair of sneakers.",
      "author": "Randy26",
      "locale": "en_GB",
      "isRecommended": true,
      "isRatingsOnly": false,
      "isSyndicated": true,
      "syndicationSource": "adidas.com",
      "submittedUTC": 1790272577000,
      "colour": "MULTI",
      "secondaryRatings": [
        {
          "id": "Size",
          "label": "Size",
          "value": 3,
          "valueLabel": "True to Size",
          "range": 5
        },
        {
          "id": "Comfort",
          "label": "Comfort",
          "value": 5,
          "range": 5
        }
      ]
    }
  ],
  "relatedProducts": [
    {
      "id": "203845770",
      "url": "https://www.asos.com/prd/203845770",
      "title": "adidas Originals Handball Spezial gum sole trainers in navy",
      "brand": "adidas Originals",
      "colour": "NAVY",
      "imageUrl": "https://images.asos-media.com/products/adidas-originals-handball-spezial-gum-sole-trainers-in-navy/203845770-1-navy",
      "isInStock": true,
      "isSelected": false
    },
    {
      "id": "203845843",
      "url": "https://www.asos.com/prd/203845843",
      "title": "adidas Originals Handball Spezial gum sole trainers in black",
      "brand": "adidas Originals",
      "colour": "BLACK",
      "imageUrl": "https://images.asos-media.com/products/adidas-originals-handball-spezial-gum-sole-trainers-in-black/203845843-1-black",
      "isInStock": true,
      "isSelected": false
    }
  ],
  "extraInfo": {
    "productCode": "133694500",
    "gender": "Unisex",
    "productType": {
      "id": 8606,
      "name": "Trainers"
    },
    "brandId": 18,
    "pdpLayout": "Footwear",
    "sizeGuideUrl": "https://www.asos.com/web/pages/size-guides/index.html?sizeSchema=UK&data=https://www.asos.com/api/sizing/sizeapi/v1/SizeGuide/1049%3flanguage%3den-GB",
    "isNoSize": false,
    "isOneSize": false,
    "isDiscontinued": false,
    "hasVariantsWithProp65Risk": true,
    "countryOfManufacture": "ID",
    "primarySupplierId": "1100000119",
    "plpIds": [
      {
        "id": 4172,
        "type": "SEO"
      },
      {
        "id": 4209,
        "type": "Standard"
      }
    ],
    "sellingTags": [
      "RP - FP list - WK51",
      "BF RP - BH - Full Price Lne Lst"
    ],
    "looks": [
      {
        "id": 211827146,
        "type": "stylingLook"
      },
      {
        "id": 211826940,
        "type": "stylingLook"
      }
    ],
    "hasMultipleColoursInStock": false,
    "hasMultiplePricesInStock": false,
    "restockingLeadTime": 14,
    "colourGroup": {
      "id": 207300462,
      "name": "handballs core colours"
    },
    "localisedUrls": {
      "en-GB": "https://www.asos.com/adidas-originals/adidas-originals-handball-spezial-gum-sole-trainers-in-brown-and-white/prd/205774480",
      "sv-SE": "https://www.asos.com/se/adidas-originals/adidas-originals-handball-spezial-bruna-och-vita-traningsskor-med-gummisula/prd/205774480"
    },
    "localisedTitles": {
      "en-GB": "adidas Originals Handball Spezial gum sole trainers in brown and white",
      "sv-SE": "adidas Originals – Handball Spezial – Bruna och vita träningsskor med gummisula"
    }
  }
}

A product group has the same shape, with its pieces in subProducts and their ids in source.bundleIds.

🗂️ Category

From a storefront or department start URL. Every menu path leading to the category is listed — the last title is the menu entry's own label, which for a filtered entry ("Wine dresses") differs from the category it opens (Dresses). Facets carry the product count behind each refinement value (brand, size, colour, price range, ...). Arrays are shortened below.

{
  "id": "8799",
  "title": "Dresses",
  "handle": "women/dresses",
  "description": "",
  "productsCount": 19663,
  "retailer": "ASOS",
  "url": "https://www.asos.com/women/dresses/cat/?cid=8799",
  "store": "COM",
  "country": "GB",
  "language": "en-GB",
  "currency": "GBP",
  "paths": [
    [
      "Women",
      "Categories",
      "Clothing",
      "SHOP by product",
      "Dresses"
    ],
    [
      "Women",
      "Categories",
      "Dresses",
      "Shop by type",
      "View all"
    ]
  ],
  "department": "Women",
  "facets": [
    {
      "id": "range",
      "name": "Sale/New Season",
      "values": [
        {
          "id": "new_season",
          "name": "New Season",
          "count": 6810
        },
        {
          "id": "sale",
          "name": "Sale",
          "count": 12839
        }
      ],
      "type": "TextMultiSelect"
    },
    {
      "id": "brand",
      "name": "Brand",
      "values": [
        {
          "id": "15643",
          "name": "4505",
          "count": 14
        },
        {
          "id": "13511",
          "name": "ASOS Curve",
          "count": 390
        }
      ],
      "type": "TextMultiSelect"
    }
  ]
}

💳 Pricing

This Actor uses pay per event: you pay for the data saved to the dataset, not for compute time. The event prices are on the Actor's pricing tab.

Event	Charged
🛍️ product	Once per product saved. A product group is charged once per piece in it.
🗂️ category	Once per category record from a storefront or department URL.
⭐ reviews	Once per product saved with review data (rating statistics, AI summary or reviews). Only with withReviews.
❤️ saved-count	Once per product saved with its saved-for-later count. Only with withSavedCount.
🎨 other-colours	Once per product saved with its other colours. Only with withOtherColours.

Extras are charged only when ASOS actually has the data: a product without reviews, saves or other colours is not charged for them. You are never charged for failed requests, products that could not be found, or the same product twice in one run. Set Max total charge on the run to cap spend — the Actor stops cleanly at the limit and keeps everything already saved.