# Cotton On Scraper - Products, Prices, Sizes & Reviews (`abotapi/cottonon-com-scraper`) Actor Scrape the Cotton On Group storefronts: Cotton On, Body, Kids, Typo, Factorie and Supre. Category, sale and gift listings with prices and colors, full product details, sizes and member reviews. Search and URL modes with sorting and scheduled change tracking. - **URL**: https://apify.com/abotapi/cottonon-com-scraper.md - **Developed by:** [Abot API](https://apify.com/abotapi) (community) - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.20 / 1,000 product records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Cotton On Group Scraper: Products, Prices & Reviews Cotton On Group Scraper turns the Cotton On Group storefronts into a clean product API. Walk any category across Cotton On, Cotton On Body, Cotton On Kids, Typo, Factorie and Supre, browse sale and gift guides, search keywords, or paste product links, and get structured rows with prices and was-prices, colors and colorway counts, size availability with fit feedback, barcodes, image galleries, and member reviews with star breakdowns - then export to JSON, CSV or Excel, or pull the results straight into your app through the API. ### Why This Scraper? - **Every brand, one actor.** The Group's six storefront brands share one catalog: categories, sale, gift guides and product pages all read through the same grammar, across the Australian, New Zealand, United States, United Kingdom and Singapore storefronts. - **Three ways in.** Keyword search, pasted category or product links (any mix), or a bare run that walks one example of every surface by default. - **Full price picture.** Current price, was-price, discount percentage and currency on every row - sale pages and clearance included. - **Real detail reads.** The full written description, complete colorway list, per-size availability with sold-out sizes, average-fit feedback and the image gallery on each enriched row. - **Reviews included.** Star average, count, per-star distribution and up to 20 member reviews per product with verified-purchase badges, billed one unit per product that delivered reviews. - **Built for schedules.** Incremental mode returns only new and changed records on recurring runs, and a refused run fails loudly instead of returning an empty dataset. ### Use Cases - **Who:** price-monitoring teams - track prices, markdowns and sell-outs across every Group brand on a schedule. - **Who:** fashion resellers and affiliates - pull titles, galleries, sizes and availability into your own storefront or feed. - **Who:** review researchers - collect star distributions and review text per product for sentiment and sizing analysis. ### Data You Get > Sample shape: one row per product, from a live record. | Field | Example | |---|---| | `title` | Hold Me Cami | | `brand` | Cotton On Women | | `price` | 24.99 | | `wasPrice` | 39.99 | | `currency` | AUD | | `url` | https://cottonon.com/AU/hold-me-cami/2060406-02.html | | `color` | White | | `colorCount` | 13 | | `sizes` | \["2XS", "XS", "S", "M", "L", "XL", "2XL"] | | `sizesUnavailable` | \["XS"] | | `ean` | 9360978616223 | | `descriptionLong` | the product page's long description | | `features` | bullet list from the page's Features tab | | `sizeChart` | per-size measurements: size, columns, values | | `careInstructions` | care lines from the care tab | | `imageUrls` | \["https://cottonon.com/dw/image/
jpg", "
"] | | `reviewsAverage` | 4.33 | | `reviewsCount` | 512 | | `reviews` | \[{"reviewAuthor": "Cat431", "reviewRating": 5, "reviewTitle": "Good Quality", "reviewBody": "
"}] | | `categories` | \["Cotton On", "Women", "Clothing", "Tops"] | | `changeType` | NEW | ### How to Use 1. Pick a mode: **catalog URLs** (default) to walk categories, sale, gifts or product pages, or **keyword search** for search listings. 2. In URL mode, paste any mix of category, sale, gift and product links. In search mode, add keywords. 3. Set **Max items** for the run cap (20 by default) and keep **Fetch product details** on for descriptions, sizes, galleries and reviews. 4. Run the actor and export the dataset, or select an MCP connector to send records into your apps. **Walk categories across the brands:** ```json {"mode": "urls", "urls": ["https://cottonon.com/AU/co/women/womens-clothing/womens-tops/", "https://cottonon.com/AU/typo/typo-shop-all/", "https://cottonon.com/AU/kids/kids-boys-1-8/boys-1-8-clothing/"], "maxItems": 30} ``` **Scrape the sale and a product:** ```json {"mode": "urls", "urls": ["https://cottonon.com/AU/co/co-sale/", "https://cottonon.com/AU/hold-me-cami/2060406-02.html"], "maxItems": 20} ``` **Search keywords:** ```json {"mode": "search", "searchTerms": ["denim shorts"], "market": "AU", "maxItems": 20} ``` **Watch prices on a schedule:** ```json {"mode": "urls", "urls": ["https://cottonon.com/AU/co/co-sale/"], "incrementalMode": true, "stateKey": "sale-watch", "maxItems": 0} ``` #### Run it from your code **Run it from Python:** ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("abotapi/cottonon-com-scraper").call(run_input={ "mode": "urls", "urls": ["https://cottonon.com/AU/co/co-sale/"], "maxItems": 20, "fetchDetails": True, }) items = client.dataset(run["defaultDatasetId"]).list_items().items ``` **Run it from JavaScript:** ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('abotapi/cottonon-com-scraper').call({ mode: 'urls', urls: ['https://cottonon.com/AU/co/co-sale/'], maxItems: 20, fetchDetails: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); ``` #### Tips - Reviews bill one unit per product that delivered reviews: `maxReviews: 20` (the default) caps how many ride along per product; `maxReviews: 0` skips review reads entirely. - A product link always reads its product page: the page is that record's only data source, so the detail fee applies even with the listing-row toggle off. - Category links can be pasted from any Group brand storefront; the walk follows the link's own market. Keyword searches and review locales use the **Market** selection. ### Send results into your apps (MCP connectors) Optionally send records into the apps you already use through MCP connectors: set **MCP connectors** (for example a Notion database) and cap the export with **Max items to export per connector**. The export is a gated side channel: it never changes the dataset. | Field | What it does | |---|---| | `mcpConnectors` | Connector ids to export to (empty = no export). | | `notionParentPageUrl` | URL or id of the Notion parent page (required for the Notion connector). | | `maxNotifyListings` | Cap on records written to each connector per run. | ### Input Parameters | Parameter | Type | Default | Description | |---|---|---|---| | `mode` | string | `urls` | How to start the scrape: pasted catalog links or keyword search. | | `urls` | array | seven example links | Category, sale, gift, search or product links from any Group brand storefront. | | `searchTerms` | array | - | Keywords for search mode, for example 'denim shorts', 'laptop case'. | | `market` | string | `AU` | Storefront for keyword search and review locales: AU, NZ, US, UK or SG. | | `sort` | string | `relevance` | Category order: storefront order, new arrivals, most popular, or by price. | | `fetchDetails` | boolean | `true` | Read each product's page for the description, colorways, sizes, barcodes and gallery. | | `fetchReviews` | boolean | `true` | Carry member reviews plus the rating summary with each product. | | `maxReviews` | integer | `20` | Cap on member reviews carried per product. Set 0 to skip review reads. | | `maxItems` | integer | `20` | The single cap on the run: stop after this many records. | | `proxy` | object | shared datacenter | Leave the default for the cheapest run. Use residential if runs fail. | | `resumeFromRunId` | string | - | Paste a previous run ID or dataset ID to continue a large crawl without returning or charging for records already collected there. | | `incrementalMode` | boolean | `false` | Track changes across scheduled runs; suppress and never bill unchanged products. | | `stateKey` | string | - | Optional name for the incremental baseline. | | `emitUnchanged` | boolean | `false` | Also return unchanged records, marked and billed. | | `emitExpired` | boolean | `false` | Also return disappeared records, marked and billed. | | `ignoreFieldsForChanges` | array | - | Extra top-level fields excluded from change detection. | | `mcpConnectors` | array | - | Connector ids to export to (empty = no export). | | `notionParentPageUrl` | string | - | URL or id of the Notion parent page (required for the Notion connector). | | `maxNotifyListings` | integer | `50` | Cap on records written to each connector per run. | ### Output Example > Sample shape: one row per product, from a live record. **Live record: Hold Me Cami** ```json { "productId": "2060406-02", "title": "Hold Me Cami", "brand": "Cotton On Women", "price": 24.99, "currency": "AUD", "url": "https://cottonon.com/AU/hold-me-cami/2060406-02.html", "color": "White", "colorCount": 13, "sizes": ["2XS", "XS", "S", "M", "L", "XL", "2XL"], "ean": "9360978616223", "reviewsAverage": 4.33, "reviewsCount": 512 } ``` ### Plan Requirement This actor runs on any Apify plan. The default shared connection keeps costs low; if runs fail with connection errors, switch the proxy group to residential and try again. ### FAQ #### How much does it cost? The actor is pay per event: a start fee per run, a per-record fee for every product returned, a detail surcharge when a product page is read (on by default), and one review unit per product that delivered reviews. Exact prices are on the actor's Pricing tab. `Max items` is the cost lever: a run's record count is bounded by it. #### Is it legal to scrape the Cotton On Group storefronts? The actor reads the public catalog surfaces: the same category, search and product data any visitor sees without an account. It does not access accounts, wishlists or checkout. You are responsible for using the data in line with the site's terms of use, privacy law such as GDPR or CCPA, and applicable regulations; personal data of identifiable individuals requires a lawful basis. #### Which brands does it cover? All six Group storefronts share the one catalog: Cotton On (including Cotton On Body), Cotton On Kids, Typo, Factorie and Supre. Paste a category link from any of them, or start from the built-in default links which cover every brand section, the sale, gift guides and a product page. #### Can I get only new or changed items on a schedule? Yes. Turn on **Incremental mode** and schedule the actor. The first run returns everything matching as NEW; later runs return only NEW and UPDATED records. Price moves, sell-outs and restocks all count as changes; the listing position of a tile does not. Use **State key** to keep a monitoring campaign stable, and **Emit unchanged** or **Emit expired** only if you also want those rows (they return and bill extra rows). #### Why did a run return fewer results than the site shows? The run stops at **Max items**, which defaults to 20. Raise it, set it to 0, or narrow the scope to get a fuller slice. #### Why did my run fail instead of returning an empty dataset? A run that never got a single readable answer fails loudly with a connection message instead of reporting an empty catalog: an empty dataset always means the scope genuinely matched nothing. A run that reads some pages but is refused others still succeeds and names the refused count with a Partial results status. #### Can I use it with AI agents or MCP? Yes. Every record is plain JSON over the dataset API, and the MCP connector export sends rows straight into tools like Notion. Point an agent at the dataset items endpoint with the input above. ### 🔗 More scrapers you might like Pair this actor with these related scrapers from the same team:
👗 Showpo Scraper
Scrape Showpo women's fashion by keyword, collection or URL. Extract product prices...		👗 Fashion Nova Scraper
Scrape Fashion Nova products by keyword, collection or URL. Extract product names...
👗 Nuuly Scraper
Scrape Nuuly clothing rental products by category, brand or URL. Extract product names...		🛒 MUJI Scraper
Scrape MUJI products from the United States, Canada and Australia storefronts. Search by...
🛒 UNIQLO Scraper
Scrape UNIQLO products across 21 country storefronts in local currency. Price with pre...		👗 Rent the Runway Scraper
Scrape Rent the Runway (renttherunway.com) designer clothing and accessories by category...
👉 [Browse all abotapi scrapers](https://apify.com/abotapi) ### 💬 Support - 🐞 **Found a bug or a missing field?** Open a ticket on the [Issues tab](https://apify.com/abotapi/cottonon-com-scraper/issues/open). We usually reply within hours. - 🛠 **Need another site, extra fields or a private build?** Email . - ⭐ **Enjoying it?** A quick review on the actor page helps other users find it. # Actor input Schema ## `mode` (type: `string`): How to discover what to scrape. Paste URLs walks any mix of category, brand, sale, gifts and product links across Cotton On, Cotton On Body, Cotton On Kids, Typo, Factorie and Supre. Search reads keyword listings. ## `urls` (type: `array`): Only used when Mode = Paste catalog URLs. Paste any mix of category links (cottonon.com/AU/co/..., /AU/kids/..., /AU/typo/..., /AU/factorie/..., /AU/supre/...), sale and gift links, product links (//.html) and search links (/AU/search/?q=term). The default walks one example of every shape across the brands, sale, gifts and a product page. ## `searchTerms` (type: `array`): Only used when Mode = Keyword search. One entry per keyword (for example denim shorts, laptop case). Each entry becomes its own listing walk in the selected market. ## `market` (type: `string`): Storefront to read: Australia (default), New Zealand, United States, United Kingdom or Singapore. Category links carry their own market; keyword searches and review locales use this selection. ## `sort` (type: `string`): Order of category listings: the storefront's own order (default), new arrivals first, most popular first, or by price. Keyword search keeps its own relevance order. ## `fetchDetails` (type: `boolean`): Read each product's page for the full description, colorway list, size availability, fit feedback, barcodes and the image gallery. Off = listing rows only (cheaper, faster). ## `fetchReviews` (type: `boolean`): Carry member reviews with each product (rating, text, author, verified-purchase badge, review photos), plus the rating average and distribution. Reviews bill one unit per product that delivered reviews. ## `maxReviews` (type: `integer`): Cap on member reviews carried per product. Set 0 to skip review reads. ## `maxItems` (type: `integer`): The single cap on the run: stop after collecting this many records across all searches and links. Set 0 for no cap. ## `proxy` (type: `object`): Leave the default for the cheapest run: the catalog serves over the ordinary shared connection. If runs fail with connection errors, switch to residential. ## `resumeFromRunId` (type: `string`): Paste a previous run ID or dataset ID to continue that interrupted run without returning or charging for records already collected there. For recurring monitoring of the same scope, use Recurring updates below instead. ## `incrementalMode` (type: `boolean`): Turn this on for daily or recurring monitoring. The first run returns all matching records as NEW. Later runs return only NEW and UPDATED records. ## `stateKey` (type: `string`): Optional. Name this monitoring campaign to keep its memory stable. Leave empty to key the memory on this run setup automatically. ## `emitUnchanged` (type: `boolean`): Off by default. Turn on to also return records that have not changed since the last run, marked UNCHANGED. This returns and bills extra rows you already have. ## `emitExpired` (type: `boolean`): Off by default. Turn on to also return records that were present before but are no longer found, marked EXPIRED. Only produced when a run covered its whole setup. ## `ignoreFieldsForChanges` (type: `array`): Output field names that should NOT mark a record as UPDATED. scrapedAt is always ignored because it is stamped fresh on every fetch. ## `mcpConnectors` (type: `array`): Optionally send records into the apps you already use through MCP connectors. Empty means no export. ## `notionParentPageUrl` (type: `string`): URL or id of the Notion page under which record pages are created. Required to enable the Notion connector. ## `maxNotifyListings` (type: `integer`): Cap on records written to each connector per run. Does not affect the dataset. ## Actor input object example ```json { "mode": "urls", "urls": [ "https://cottonon.com/AU/co/women/womens-clothing/womens-tops/", "https://cottonon.com/AU/kids/kids-boys-1-8/boys-1-8-clothing/", "https://cottonon.com/AU/typo/typo-shop-all/", "https://cottonon.com/AU/factorie/f-shop-all/", "https://cottonon.com/AU/co/co-sale/", "https://cottonon.com/AU/co/co-gifts/", "https://cottonon.com/AU/hold-me-cami/2060406-02.html" ], "searchTerms": [ "denim shorts" ], "market": "AU", "sort": "relevance", "fetchDetails": true, "fetchReviews": true, "maxReviews": 20, "maxItems": 20, "proxy": { "useApifyProxy": true }, "incrementalMode": false, "emitUnchanged": false, "emitExpired": false, "maxNotifyListings": 50 } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `detail` (type: `string`): No description ## `reviews` (type: `string`): No description ## `changes` (type: `string`): No description # 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 = { "mode": "urls", "urls": [ "https://cottonon.com/AU/co/women/womens-clothing/womens-tops/", "https://cottonon.com/AU/kids/kids-boys-1-8/boys-1-8-clothing/", "https://cottonon.com/AU/typo/typo-shop-all/", "https://cottonon.com/AU/factorie/f-shop-all/", "https://cottonon.com/AU/co/co-sale/", "https://cottonon.com/AU/co/co-gifts/", "https://cottonon.com/AU/hold-me-cami/2060406-02.html" ], "searchTerms": [ "denim shorts" ], "market": "AU", "sort": "relevance", "fetchDetails": true, "fetchReviews": true, "maxReviews": 20, "maxItems": 20, "proxy": { "useApifyProxy": true }, "incrementalMode": false, "emitUnchanged": false, "emitExpired": false, "maxNotifyListings": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/cottonon-com-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 = { "mode": "urls", "urls": [ "https://cottonon.com/AU/co/women/womens-clothing/womens-tops/", "https://cottonon.com/AU/kids/kids-boys-1-8/boys-1-8-clothing/", "https://cottonon.com/AU/typo/typo-shop-all/", "https://cottonon.com/AU/factorie/f-shop-all/", "https://cottonon.com/AU/co/co-sale/", "https://cottonon.com/AU/co/co-gifts/", "https://cottonon.com/AU/hold-me-cami/2060406-02.html", ], "searchTerms": ["denim shorts"], "market": "AU", "sort": "relevance", "fetchDetails": True, "fetchReviews": True, "maxReviews": 20, "maxItems": 20, "proxy": { "useApifyProxy": True }, "incrementalMode": False, "emitUnchanged": False, "emitExpired": False, "maxNotifyListings": 50, } # Run the Actor and wait for it to finish run = client.actor("abotapi/cottonon-com-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💟 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "urls", "urls": [ "https://cottonon.com/AU/co/women/womens-clothing/womens-tops/", "https://cottonon.com/AU/kids/kids-boys-1-8/boys-1-8-clothing/", "https://cottonon.com/AU/typo/typo-shop-all/", "https://cottonon.com/AU/factorie/f-shop-all/", "https://cottonon.com/AU/co/co-sale/", "https://cottonon.com/AU/co/co-gifts/", "https://cottonon.com/AU/hold-me-cami/2060406-02.html" ], "searchTerms": [ "denim shorts" ], "market": "AU", "sort": "relevance", "fetchDetails": true, "fetchReviews": true, "maxReviews": 20, "maxItems": 20, "proxy": { "useApifyProxy": true }, "incrementalMode": false, "emitUnchanged": false, "emitExpired": false, "maxNotifyListings": 50 }' | apify call abotapi/cottonon-com-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/cottonon-com-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/wzqTBWhWifw4ELwGD/builds/qg62LvJrk4aAirtLB/openapi.json