# Mango Scraper - Prices, Rebajas, Variants & Composition (`abotapi/mango-com-scraper`) Actor Scrape Mango (shop.mango.com) fashion products: current price plus strike-through Rebajas (sale) discount, full colour/size variant matrix, section and category, and (with full detail) composition, care, materials, origin, fit and per-size availability. Search by keyword or Rebajas, or paste links. - **URL**: https://apify.com/abotapi/mango-com-scraper.md - **Developed by:** [Abot API](https://apify.com/abotapi) (community) - **Categories:** E-commerce, Developer tools, Automation - **Stats:** 4 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 product results 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? 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 ## Mango Product Scraper Pull product data from Mango (shop.mango.com), the global fashion retailer. Search by keyword or browse the site's own Rebajas (sale) feed, or paste product and listing links directly. Every record includes the current price, the strike-through original price with computed discount when a product is marked down, and the full colour/size variant matrix -- with per-size availability and composition/care/materials/fit when you ask for full detail. ### Why This Scraper? - **Was-price and discount, structured, straight from Mango's own pricing service.** When a product is marked down, both prices are captured plus the discount percentage and Mango's own promotion label. - **Rebajas, first class.** A `specialsOnly` toggle browses Mango's own, real, queryable Rebajas (sale) catalog with genuine server-side pagination -- not a guessed category. Mango Outlet is a separate site and out of scope here. - **Full colour/size matrix.** Every colourway and size Mango sells for a product, each colour with its own price/discount and image gallery; with full detail on, each size also carries real-time availability (in stock, last units, or delayed). - **Composition, care, materials, origin and fit.** With `fetchDetails` on, every product also returns its fabric composition, wash-care instructions, a material breakdown by percentage, country of origin, and garment fit measurements. - **Two ways in.** Keyword search or Rebajas browse, or paste any product/category link and continue pagination automatically. - **Optional export to your apps.** Send results into Notion, Linear, Airtable, or any Apify MCP connector alongside the dataset. ### Data You Get | Field | Example value | |---|---| | productId | `123456` | | name | `Sample Linen Trousers` | | brand / section | `Mango`, `Women` | | category / families | `Trousers`, `[{"id": "26", "label": "Trousers", "labelEn": "Trousers"}]` | | url | `https://shop.mango.com/es/es/p/mujer/pantalones/sample-linen-trousers/123456` | | price / currency | `19.99`, `EUR` | | originalPrice / discountAmount / discountPercent | `29.99`, `10.00`, `33.4` | | isOnSpecial / promoLabel | `true`, `PROMOCION HASTA REBAJAS` | | colors\[] | `[{"id": "99", "label": "Black", "rgb": "36,36,36", "sizes": [{"id": "36", "label": "36", "plusSize": false, "available": true, "isDelayed": false, "lastUnits": false}], "images": [...], "price": 19.99, ...}]` | | compositions / care / materials | `["Composition: 55% linen, 45% viscose"]`, `["Machine wash max 30°C"]`, `[{"name": "LINEN", "percent": 55}, {"name": "VISCOSE FSC", "percent": 45}]` | | originCountry | `China` | | measures | `["Inseam 76 cm", "Side length 104 cm"]` | | reviews | `{"averageRating": null, "totalReviewCount": 0, "items": []}` | > Sample shape: values above are illustrative placeholders, not from a live product. ### How to Use **1. Keyword search, default market and section (Women, Spain):** ```json { "mode": "search", "searchTerm": "vestido", "maxItems": 20 } ``` **2. Browse the UK men's Rebajas feed:** ```json { "mode": "search", "market": "gb/en", "section": "MEN", "specialsOnly": true, "maxItems": 50, "maxPages": 5 } ``` **3. Full product detail (composition, care, per-size availability) for a pasted product link:** ```json { "mode": "url", "urls": ["https://shop.mango.com/es/es/p/mujer/sample-linen-trousers/123456"], "fetchDetails": true } ``` **4. Paste a category/Rebajas listing and keep paginating forward:** ```json { "mode": "url", "urls": ["https://shop.mango.com/es/es/c/mujer/rebajas--70/93ea7423"], "maxItems": 100, "maxPages": 10 } ``` **5. Continue a previous run, collecting only new products:** ```json { "mode": "search", "specialsOnly": true, "resumeFromRunId": "" } ``` **6. Daily/recurring monitoring of the same search, only what changed:** ```json { "mode": "search", "specialsOnly": true, "section": "WOMEN", "incrementalMode": true } ``` The first run returns everything as `NEW`. Every later run against the same search/section/URL set returns only `NEW`, `UPDATED`, and `REAPPEARED` products -- unchanged and expired products are suppressed by default. Turn on `emitUnchanged` / `emitExpired` to also get those (and be billed for them). ### Input Parameters | Parameter | Type | Description | |---|---|---| | `mode` | string | `search` or `url`. | | `market` | string | Mango's own market path prefix, e.g. `es/es`, `gb/en` (search mode only; a pasted URL carries its own market). | | `section` | string | `WOMEN` or `MEN` (search mode only). Other Mango sections can still be scraped via pasted URLs. | | `searchTerm` | string | Keyword (search mode only). Mango's own search results page does not paginate. | | `specialsOnly` | boolean | Browse Mango's real Rebajas catalog for the chosen section instead of keyword search (search mode only). | | `minPrice` / `maxPrice` | number | Price band to keep, in the market's own currency. | | `urls` | array | Product or category/Rebajas listing URLs to scrape (url mode only). | | `fetchDetails` | boolean | Fetch composition, care, materials, origin, fit measures, and per-size availability. | | `maxPages` | integer | Cap on result pages per Rebajas/URL entry; `0` (default) = unlimited, walk every page until the site stops returning new products or Max products total is hit. Keyword search is always one page. | | `maxItems` | integer | Cap on total products returned; `0` = unlimited. | | `resumeFromRunId` | string | Optional: a previous run id (or its dataset id). Products it already collected are skipped, so this run returns only new products (a delta). Leave empty for a normal run. Use Incremental mode instead for recurring monitoring of the same search. | | `incrementalMode` | boolean | Off by default. Turn on for daily/recurring monitoring of the same search: the first run returns everything as `NEW`, later runs return only `NEW`/`UPDATED`/`REAPPEARED` (plus `UNCHANGED`/`EXPIRED` if requested below). State is kept per mode/section/search/URL/detail combination. | | `stateKey` | string | Optional: name a monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Auto-derived from the search/URL/detail settings when left empty. | | `emitUnchanged` | boolean | Off by default. Also return (and bill) products that have not changed since the last run, marked `UNCHANGED`. | | `emitExpired` | boolean | Off by default. Also return (and bill) products that were present before but are no longer found, marked `EXPIRED`. Only produced after a complete scan of the tracked search/URLs -- not when Max products capped it or Resume was used. | | `proxy` | object | Connection settings. This actor always uses Apify RESIDENTIAL underneath regardless of this setting -- see the note below. | | `mcpConnectors` | array | Optional MCP connectors to export results into (Notion, Linear, Airtable, Apify). | | `notionParentPageUrl` | string | Notion connector only: page under which item pages are created. | | `maxNotifyListings` | integer | Cap on items exported to each connector per run. Does not affect the dataset. | ### Output Example ```json { "productId": "123456", "name": "Sample Linen Trousers", "brand": "Mango", "section": "Women", "collection": "OI2026", "model": "SACO", "category": "Trousers", "families": [{ "id": "26", "label": "Trousers", "labelEn": "Trousers" }], "url": "https://shop.mango.com/es/es/p/mujer/pantalones/sample-linen-trousers/123456", "price": 19.99, "currency": "EUR", "originalPrice": 29.99, "discountAmount": 10.0, "discountPercent": 33.4, "isOnSpecial": true, "promoLabel": "PROMOCION HASTA REBAJAS", "image": "https://media.mango.com/is/image/punto/123456-99-002", "defaultColorId": "99", "colors": [ { "id": "99", "label": "Black", "rgb": "36,36,36", "sizes": [ { "id": "36", "label": "36", "plusSize": false, "available": true, "isDelayed": false, "lastUnits": false } ], "images": [{ "code": "002", "url": "https://media.mango.com/is/image/punto/123456-99-002", "alt": "Sample Linen Trousers" }], "price": 19.99, "currency": "EUR", "originalPrice": 29.99, "discountAmount": 10.0, "discountPercent": 33.4, "isOnSpecial": true, "promoLabel": "PROMOCION HASTA REBAJAS" } ], "compositions": ["Composition: 55% linen, 45% viscose"], "care": ["Machine wash max 30°C, short spin", "Do not bleach"], "materials": [{ "name": "LINEN", "percent": 55 }, { "name": "VISCOSE FSC", "percent": 45 }], "originCountry": "China", "measures": ["Inseam 76 cm", "Side length 104 cm"], "lastUnits": false, "isSellable": true, "isUniqueSize": false, "reviews": { "averageRating": null, "totalReviewCount": 0, "items": [] } } ``` > Sample shape: values above are illustrative placeholders, not from a live product. ### A note on reviews, sort, and brand/filters Mango does not surface customer reviews on its product pages -- `reviews` is always returned as an empty structure rather than omitted or guessed. No server-side sort parameter was found on any Mango listing or search route in live testing, so none is exposed here rather than faking one. Mango is a single-brand shop, so there is no brand filter -- every record's `brand` is `Mango`. ### A note on proxy and cost This actor always connects over a residential proxy internally, matched to your requested market's country, regardless of the `proxy` input. Residential traffic is billed at a materially higher rate; factor this into large runs. ### Send results into your apps (MCP connectors) Optionally pipe results into the apps you already use through Model Context Protocol (MCP) connectors. Authorize a connector once under Apify, Settings, Integrations, then select it in the `mcpConnectors` field. Each connector receives a condensed, human-readable summary per product (name plus key fields), while the complete record always stays in the Apify dataset. For Notion, set `notionParentPageUrl` to the page the item pages should be created under, and use `maxNotifyListings` to cap how many items are exported per connector per run. Supported connectors: Notion, Linear, Airtable, and Apify. Leave the field empty to skip; it never changes the dataset output. # Actor input Schema ## `mode` (type: `string`): 'search' finds products by keyword and/or Mango's own Rebajas (sale) feed for a chosen section. 'url' scrapes any product or category/Rebajas listing page URL you paste, walking pagination forward automatically. ## `market` (type: `string`): Mango's own market path prefix, e.g. 'es/es' (Spain, Castellano) or 'gb/en' (UK, English). Applies to search mode; a pasted URL in url mode carries its own market instead. ## `section` (type: `string`): Which Mango nav section to search/browse. Only Women and Men are wired to keyword search and the Rebajas feed below; other sections (Teen, Kids, Home) can still be scraped via pasted URLs in url mode. ## `searchTerm` (type: `string`): Free-text keyword, e.g. 'vestido' or 'pantalon lino'. Mango's own search results page does not paginate (verified live), so a keyword search always returns a single page of results. Leave empty and use Rebajas only below to browse the sale feed without a keyword. ## `specialsOnly` (type: `boolean`): Browse Mango's own, real, queryable Rebajas (sale) catalog for the chosen section, with genuine server-side pagination -- verified live (2000+ items across dozens of pages). Does not combine with a keyword (mango.com's search and its Rebajas catalog are two separate systems); a keyword is ignored when this is on. Mango has no separate 'Outlet' catalog on shop.mango.com itself (Mango Outlet is a distinct site, out of scope here), so Rebajas is the site's one real specials taxonomy. ## `urls` (type: `array`): Paste one or more mango.com product pages or category/Rebajas listing pages, in any market. Pagination continues forward automatically from any ?page= already in the URL. Search-mode fields are ignored here. The fields in the Filters section still apply, including to a pasted product URL. ## `minPrice` (type: `number`): Only return products priced at or above this amount, in the market's own currency. Applies in BOTH search mode and URL mode, including a pasted product URL. ## `maxPrice` (type: `number`): Only return products priced at or below this amount, in the market's own currency. Applies in BOTH search mode and URL mode, including a pasted product URL. ## `fetchDetails` (type: `boolean`): Adds composition, care instructions, material breakdown by percentage, country of origin, fit/garment measurements, and per-size availability (in stock / last units / delayed) from the product page. Current price, was-price/discount, and the colour/size matrix (without per-size availability) are already included without this toggle. A pasted product URL in url mode always fetches full detail regardless of this toggle. ## `maxPages` (type: `integer`): Stop after this many result pages per Rebajas/URL entry. Only applies to Rebajas browsing and pasted category URLs (keyword search is always a single page). 0 (default) = unlimited -- walk every page until the site stops returning new products or Max products total is hit. ## `maxItems` (type: `integer`): Hard cap on total products returned across every search/URL entry. 0 = unlimited (still bounded by Max pages per search). ## `resumeFromRunId` (type: `string`): Paste a previous run id (or its dataset id) to continue a large crawl without returning or charging for products already collected there. Use this after an interrupted run, or when continuing a product pull in another run. For recurring monitoring of the same search/section/URLs, use Incremental mode below instead. ## `incrementalMode` (type: `boolean`): Turn this on for daily or recurring monitoring. The first run returns all matching products as NEW. Later runs normally return only NEW, UPDATED, and REAPPEARED products. Turn on "Emit unchanged" or "Emit expired" only when you also want those products returned (and billed). State is kept separately for each mode/section/search/URL and detail-mode setup; use State key when you want to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from a previous run above. ## `stateKey` (type: `string`): Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Leave empty to let the actor derive a key automatically from the mode/section/search/URL and detail settings -- different searches then never mix state with each other. ## `emitUnchanged` (type: `boolean`): Off by default. Turn on to also return products that have not changed since the last run, marked UNCHANGED. This returns -- and bills -- extra rows you already have, so leave it off unless you specifically want the full snapshot every run. ## `emitExpired` (type: `boolean`): Off by default. Turn on to also return products that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned the tracked search/URLs -- not when Max products capped it, or when Resume was used. This returns -- and bills -- extra synthetic rows, so leave it off unless you need expiry tracking. ## `proxy` (type: `object`): This actor always connects over a residential proxy (country matched to your requested market), regardless of what is selected here. Residential is billed at a higher rate, so factor this into your usage. ## `mcpConnectors` (type: `array`): Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify -> Settings -> Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com). ## `notionParentPageUrl` (type: `string`): URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors. ## `maxNotifyListings` (type: `integer`): Cap on items written to each connector per run. Does not affect the dataset. ## Actor input object example ```json { "mode": "search", "market": "es/es", "section": "WOMEN", "searchTerm": "vestido", "specialsOnly": false, "urls": [ "https://shop.mango.com/es/es/c/mujer/rebajas--70/93ea7423" ], "fetchDetails": false, "maxPages": 0, "maxItems": 20, "incrementalMode": false, "emitUnchanged": false, "emitExpired": false, "proxy": { "useApifyProxy": true }, "maxNotifyListings": 50 } ``` # Actor output Schema ## `overview` (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": "search", "market": "es/es", "searchTerm": "vestido", "urls": [ "https://shop.mango.com/es/es/c/mujer/rebajas--70/93ea7423" ], "incrementalMode": false, "emitUnchanged": false, "emitExpired": false, "proxy": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/mango-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": "search", "market": "es/es", "searchTerm": "vestido", "urls": ["https://shop.mango.com/es/es/c/mujer/rebajas--70/93ea7423"], "incrementalMode": False, "emitUnchanged": False, "emitExpired": False, "proxy": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/mango-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": "search", "market": "es/es", "searchTerm": "vestido", "urls": [ "https://shop.mango.com/es/es/c/mujer/rebajas--70/93ea7423" ], "incrementalMode": false, "emitUnchanged": false, "emitExpired": false, "proxy": { "useApifyProxy": true } }' | apify call abotapi/mango-com-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/mango-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/7L0Gb44hFULQ1l1wE/builds/7Fj4sTYMLMokZ2AOz/openapi.json