# Marks & Spencer Product Scraper (`sian.agency/marks-and-spencer-product-scraper`) Actor Scrape Marks & Spencer products โ€” fashion, home & beauty. Search or browse by department, get prices, was-prices, ratings, colour/size variants, images, material & care specs. - **URL**: https://apify.com/sian.agency/marks-and-spencer-product-scraper.md - **Developed by:** [SIรN Oรœ](https://apify.com/sian.agency) (community) - **Categories:** E-commerce, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 overview product extracteds 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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 ## Marks & Spencer Product Scraper โ€” Prices, Variants, Ratings & Specs to JSON/CSV ๐Ÿš€ [![SIรN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Nike Product Scraper](https://img.shields.io/badge/Store-Nike%20Product%20Scraper-111111)](https://apify.com/sian.agency/nike-product-scraper?fpr=sian) [![Currys Product Scraper](https://img.shields.io/badge/Store-Currys%20Product%20Scraper-6E2585)](https://apify.com/sian.agency/currys-product-scraper?fpr=sian) [![Tesco Product Scraper](https://img.shields.io/badge/Store-Tesco%20Product%20Scraper-00539F)](https://apify.com/sian.agency/tesco-product-scraper?fpr=sian) #### ๐ŸŽ‰ Turn any M&S search, category, or product page into a clean dataset โ€” prices, was-prices, colour & size variants, ratings, images, and full material & care specs in a single run. ##### Perfect for fashion price analysts, retail buyers, comparison sites, and catalog teams who need reliable Marks & Spencer data without lifting a finger. --- ### ๐Ÿ“‹ Overview **The Marks & Spencer Product Scraper turns marksandspencer.com into structured data in seconds.** Search by keyword, browse any department or category, apply M&S's own filters, or paste product and listing URLs โ€” and get a clean JSON/CSV dataset with one row per product covering prices, was-prices, ratings, colour and size variants, images, availability, and full material and care specs. No account, no API key, no setup. Just enter what you want, click Run, and download export-ready data for price and discount monitoring, competitor intelligence, and catalog enrichment across M&S fashion, home & beauty. **Why professionals choose us:** - โœ… **Zero Setup**: No M&S account or API key โ€” enter keywords, a department, or URLs and go - โšก **Fast Overview Mode**: Pull search and category results at scale (48 products per page) โ€” id, brand, title, price, was-price, rating, variants, images, and stock - ๐Ÿท๏ธ **Discounts Built In**: Capture both the current price and the original was-price so you can measure real markdowns and track promotions - ๐Ÿ‘— **Deep Detail Mode**: Enrich every product with full description, material & composition, care specs, every colour & size, all images, and the complete ratings breakdown - ๐Ÿ’ฐ **Pay-Per-Result Pricing**: Only pay for the products you actually receive โ€” plus a free tier to test risk-free - ๐Ÿ’Ž **One Clean Record Per Product**: Overview and detail are merged into a single row โ€” no stitching, no duplicates - โœจ **NEW: Ratings Deep-Dive**: Get the full star distribution plus TrueToSize, Value, Style, and Material sub-scores for every product --- ### โœจ Features - ๐Ÿ” **Keyword & Category Search**: Find products by free-text search or by browsing any M&S department and category - ๐Ÿ—‚๏ธ **Department Browsing**: Target women, men, kids, lingerie, beauty, home-and-furniture, flowers-and-plants, or gifts - ๐ŸŽ›๏ธ **Native M&S Filters**: Apply M&S's own facet filters (colour, size, material, style โ€” e.g. `blue`, `cotton`, `midi-dresses`) - ๐Ÿ”— **Paste M&S URLs**: Drop in any marksandspencer.com search or product-listing URL and scrape it directly - โšก **Overview Mode**: Fast results extraction โ€” product id, brand & sub-brand, title, product type, price, was-price, rating, review count, hero images, colour/size variants, stock, and labels - ๐Ÿ“ **Detail Mode**: Full description, material & composition, care specs, every colour & size, the complete image gallery, availability, and the ratings breakdown - ๐Ÿท๏ธ **Price & Discount Capture**: Current price and original was-price in GBP (ยฃ) for true markdown tracking - โญ **Ratings & Review Signals**: Average rating, review count, star distribution, and TrueToSize / Value / Style / Material sub-scores - ๐Ÿ“ฆ **Availability Intelligence**: In-stock status and stock indicator for stock and range checks - ๐ŸŽš๏ธ **Sorting & Price Band**: Sort by relevance, new-in, best-selling, price lowโ†’high, price highโ†’low, or rating โ€” plus a min/max price band - ๐Ÿ’พ **Clean JSON & CSV**: Export-ready dataset with one row per product, priced in GBP (ยฃ) --- ### ๐ŸŽฌ Quick Start Enter keywords, a department & category, native filters, or M&S URLs, pick a mode, and click Run. Results land in your dataset ready to export. ```bash ## Run via API - one line curl -X POST https://api.apify.com/v2/acts/sian.agency~marks-and-spencer-product-scraper/runs?token=[YOUR_TOKEN] \ -d '{"queries": ["cashmere jumper"], "scrapeMode": "overview"}' ```` *** ### ๐Ÿš€ Getting Started (3 Simple Steps) #### Step 1: Tell It What to Scrape Enter search keywords (e.g. `cashmere jumper`, `midi dress`, `bath towels`), pick a department and category (e.g. `women` + `dresses`), add M\&S facet filters, or paste marksandspencer.com URLs. Mix and match as needed. #### Step 2: Choose Mode & Filters Pick **Overview** (fast search and category data) or **Detail** (enriched with description, material, care specs, and full ratings breakdown). Optionally set a sort order (relevance, new, best-selling, price lowโ†’high, price highโ†’low, rating) and a min/max price band. #### Step 3: Run & Download Click Run and download clean, structured data as JSON, CSV, or Excel โ€” ready for spreadsheets, databases, and analytics tools. **That's it! In minutes, you'll have:** - Live prices and original was-prices, so you can track discounts and markdowns - Ratings, review counts, images, colour/size variants, and availability for every product - Full descriptions, material & composition, care specs, and the ratings deep-dive (detail mode) - Clean export-ready data priced in GBP (ยฃ), one row per product *** ### ๐Ÿ“ฅ Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | queries | array | No | Free-text M\&S searches, one per line (e.g. `"cashmere jumper"`, `"midi dress"`) | | scrapeMode | string | No | `overview` (fast) or `detail` (description, material, care specs, full ratings) | | department | string | No | Top department to browse: `women`, `men`, `kids`, `lingerie`, `beauty`, `home-and-furniture`, `flowers-and-plants`, `gifts` | | category | string | No | Category subpath under the department (e.g. `dresses`) | | facets | array | No | M\&S fs5 filter slugs โ€” colour / size / material / style (e.g. `blue`, `cotton`, `midi-dresses`) | | urls | array | No | Paste M\&S product-listing or search URLs to scrape directly | | sort | string | No | `relevance`, `new`, `best_selling`, `price_low`, `price_high`, `rating` | | minPrice | number | No | Only return products at or above this price (GBP) | | maxPrice | number | No | Only return products at or below this price (GBP) | | maxResults | integer | No | Maximum number of products to return across all searches | **Example โ€” keyword search, detail mode:** ```json { "queries": ["cashmere jumper"], "scrapeMode": "detail", "sort": "price_low", "minPrice": 20, "maxPrice": 120, "maxResults": 100 } ``` **Example โ€” browse a department & category with M\&S filters:** ```json { "department": "women", "category": "dresses", "facets": ["midi-dresses", "blue"], "scrapeMode": "overview", "sort": "best_selling" } ``` **Example โ€” scrape M\&S URLs directly:** ```json { "urls": [ "https://www.marksandspencer.com/l/women/dresses", "https://www.marksandspencer.com/search?q=cashmere+jumper" ], "scrapeMode": "detail" } ``` *** ### ๐Ÿ“ค Output Results are saved to the Apify dataset with **30+ fields per product**, one clean row each. In detail mode, the overview row is enriched in place with the description, material, care specs, every colour & size, the full image gallery, and the ratings breakdown โ€” no separate records to merge. | Field | Type | Description | |-------|------|-------------| | item\_id | string | M\&S product ID | | productTitle | string | Full product name | | url | string | Product page URL | | brand | string | Brand name (e.g. Autograph, M\&S Collection) | | sub\_brand | string | Sub-brand, when present | | product\_type | string | Product type (e.g. Jumpers, Dresses) | | department | string | Department the product sits in | | price | number | Current price (GBP) | | original\_price | number | Original was-price before markdown (GBP) | | currency | string | Currency code (GBP) | | rating | number | Average star rating | | review\_count | number | Total number of reviews | | in\_stock | boolean | Whether the product is currently in stock | | stock\_indicator | string | Stock-level indicator | | images | array | Full product image gallery | | breadcrumbs | array | Category breadcrumb trail | | labels | array | Product labels / badges (e.g. new-in, offer) | | colours | array | Available colours | | sizes | array | Available sizes | | variant\_count | number | Number of colour/size variants | | description | string | Full product description (detail) | | material | string | Material / composition (detail) | | specs | object | Care & product specs, e.g. machine washable, fit (detail) | | rating\_distribution | object | Star distribution โ€” count per 1โ€“5 stars (detail) | | secondary\_ratings | object | TrueToSize, Value, Style, Material sub-scores (detail) | | metadata | object | Run metadata (mode, searches, sort, timestamp) | **Full example (detail mode):** ```json { "thumbnail": "https://assets.digitalcontent.marksandspencer.app/images/q_auto,f_auto/SD_03_T30_4141A_F3_X_EC_0/Pure-Cashmere-V-Neck-Jumper", "item_id": "60744578", "productTitle": "Pure Cashmere V-Neck Jumper", "url": "https://www.marksandspencer.com/pure-cashmere-v-neck-jumper/p/clp60744581?color=DARKNAVY", "source": "detail", "brand": "Autograph", "sub_brand": null, "product_type": "Jumpers", "department": "men", "external_id": "P60744581", "price": 99, "original_price": null, "currency": "GBP", "rating": 4.53, "review_count": 58, "images": [ "https://assets.digitalcontent.marksandspencer.app/images/.../F3_X_EC_0/Pure-Cashmere-V-Neck-Jumper", "https://assets.digitalcontent.marksandspencer.app/images/.../F3_X_EC_90/Pure-Cashmere-V-Neck-Jumper", "https://assets.digitalcontent.marksandspencer.app/images/.../F3_X_EC_1/Pure-Cashmere-V-Neck-Jumper" ], "in_stock": true, "stock_indicator": "M", "breadcrumbs": ["Men", "Men's Knitwear", "Men's Jumpers"], "labels": [], "colours": ["Dark Navy", "Black", "Smokey Blue"], "sizes": ["S Regular", "M Regular", "L Regular", "XL Regular", "2XL Regular"], "variant_count": 3, "description": "Add a touch of luxury to your knitwear collection with this cashmere jumper from our Autograph collection. It's made from pure cashmere for a soft and comfortable feel. A v-neck and ribbed trims add classic finishing touches.", "material": "100% cashmere", "specs": { "Regular fit": "Yes", "Machine washable": "Yes", "Product type": "Jumpers" }, "rating_distribution": { "1": 2, "2": 1, "3": 2, "4": 12, "5": 41 }, "secondary_ratings": { "TrueToSize": 4.15, "Value": 4.64, "Style": 4.45, "Material": 4.45 }, "metadata": { "scrapeMode": "detail", "sort": "relevance", "scrapedAt": "2026-07-14T15:28:28.680Z" } } ``` *** ### ๐Ÿ’ผ Use Cases & Examples #### 1. Fashion Price & Discount Monitoring **Retail and pricing teams tracking M\&S prices, was-prices, and markdowns over time.** **Input:** Keywords, or a department & category for your product lines **Output:** Current price, original was-price, and labels for every product **Use:** Detect price drops and seasonal markdowns the moment they go live and react faster. #### 2. Competitor & Assortment Intelligence **Category managers and buyers mapping what M\&S carries and how it's priced.** **Input:** Department and category paths (e.g. `women` + `dresses`), overview mode **Output:** Full product lists with brand, sub-brand, product type, price, rating, and breadcrumbs **Use:** Understand range breadth, brand mix, colour/size depth, and price distribution at a glance. #### 3. Product Feeds & Catalog Enrichment **App, feed, and marketplace teams building rich M\&S product catalogs.** **Input:** Keywords or URLs, detail mode **Output:** Descriptions, material & composition, care specs, colours, sizes, and full image galleries **Use:** Populate product feeds and catalogs with accurate, export-ready fashion and home data. #### 4. In-Stock & Availability Tracking **Resellers and analysts monitoring what's available at M\&S.** **Input:** Keywords or URLs for the products you follow **Output:** In-stock status and stock indicator for every product **Use:** Track availability and sell-through and only surface what's actually in stock. #### 5. Material & Care-Label Extraction **Sustainability, sourcing, and quality teams needing composition and care data.** **Input:** Product URLs or keywords, detail mode **Output:** Material & composition (e.g. `100% cashmere`) and care specs (machine washable, fit, and more) **Use:** Build fabric and care databases for sourcing, compliance, and product comparison. #### 6. Ratings & Review-Signal Research **Insight teams studying how M\&S products are received.** **Input:** Keywords or a category, detail mode **Output:** Average rating, review count, star distribution, and TrueToSize / Value / Style / Material sub-scores **Use:** Benchmark product sentiment, fit accuracy, and perceived value across a range. #### 7. Trend & New-In Tracking **Trend forecasters and merchandisers watching what's launching at M\&S.** **Input:** A department & category sorted by `new`, or keywords with the new-in labels **Output:** Freshly listed products with brand, price, colours, images, and labels **Use:** Spot new arrivals and emerging styles early to inform buying and content calendars. *** ### ๐Ÿ”— Integration Examples #### JavaScript/Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('sian.agency/marks-and-spencer-product-scraper').call({ queries: ['cashmere jumper'], scrapeMode: 'detail', maxResults: 100 }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0]); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_TOKEN') run = client.actor('sian.agency/marks-and-spencer-product-scraper').call( run_input={'queries': ['cashmere jumper'], 'scrapeMode': 'detail'} ) for item in client.dataset(run['defaultDatasetId']).iterate_items(): print(item) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/sian.agency~marks-and-spencer-product-scraper/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"queries": ["cashmere jumper"], "scrapeMode": "detail"}' ``` #### Automation Workflows (N8N / Zapier / Make) 1. **Trigger**: Schedule or webhook 2. **HTTP Request**: Call the actor API 3. **Process**: Handle the JSON product results 4. **Action**: Save to a database, update a pricing sheet, or send an alert *** ### ๐Ÿ“Š Performance & Pricing #### FREE Tier (Try It Now) - **Up to 25 products** per run โ€” full feature access, same data quality - No credit card required - Perfect for testing keywords, departments, and detail mode #### PAID Tier (Production Ready) - **Unlimited** products per run - Faster, at-scale extraction with no caps - **Pay-per-result**: you're only charged for products that are successfully extracted ๐Ÿ’ฐ **Fair, transparent pricing** โ€” pay for the products you get, nothing more. ๐Ÿ”— [View current pricing](https://apify.com/sian.agency/marks-and-spencer-product-scraper?fpr=sian) *** ### โ“ Frequently Asked Questions **Q: How many products can I scrape?** A: FREE tier: up to 25 products per run. PAID tier: unlimited. **Q: Do I need a Marks & Spencer account or API key?** A: No. There's nothing to sign up for or configure โ€” just enter keywords, a department, facets, or URLs and run. **Q: What's the difference between Overview and Detail mode?** A: Overview is the fast path โ€” search and category data like product id, brand, title, product type, price, was-price, rating, review count, hero images, colour/size variants, and stock. Detail enriches each product with the full description, material & composition, care specs, every colour & size, the complete image gallery, availability, and the ratings breakdown (star distribution plus TrueToSize, Value, Style, and Material sub-scores). **Q: Does it capture discounts and was-prices?** A: Yes โ€” every product includes the current price and, where present, the original was-price in GBP (ยฃ), so you can measure real markdowns. **Q: Can I filter and sort results?** A: Yes โ€” sort by relevance, new, best-selling, price lowโ†’high, price highโ†’low, or rating, apply M\&S's own facet filters (colour, size, material, style), and set a min/max price band. **Q: What output formats are available?** A: JSON, CSV, and Excel โ€” export directly from the Apify dataset. **Q: Which region and currency does it cover?** A: The UK storefront (marksandspencer.com), with prices in GBP (ยฃ). **Q: Is this legal?** A: Yes โ€” the actor accesses only publicly available data. See the [legal section](#-is-it-legal-to-scrape-data) below. *** ### ๐Ÿ› Troubleshooting **No results returned** - Check keyword spelling and try broader terms (e.g. `jumper` instead of an exact product name) - Remove or widen filters (facets, min/max price) and confirm the department/category path is valid - Verify any M\&S URLs open correctly in a browser **Description, material, or care specs are missing** - Switch `scrapeMode` to `detail` โ€” descriptions, material & composition, care specs, and the ratings breakdown are only extracted in detail mode **Fewer products than expected** - FREE tier is capped at 25 products per run โ€” upgrade to PAID for unlimited results - Some categories or filtered searches simply contain fewer products **Prices look different from what I expect** - Results reflect the UK storefront (marksandspencer.com) in GBP (ยฃ); promotions may change and online prices can differ from in-store *** ### โš–๏ธ Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what is publicly available. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data (for example, reviewer names). Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). **Trademark & affiliation disclaimer:** This actor and SIรN Agency are independent and are **not affiliated with, endorsed by, or sponsored by Marks and Spencer plc** or "M\&S". "Marks & Spencer", "M\&S", and all related names, marks, and logos are trademarks of their respective owners. This actor is not an official Marks & Spencer product or service; it extracts only publicly available data for legitimate research purposes, and users are responsible for ensuring their use complies with all applicable laws and terms. *** ### ๐Ÿค Support [![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi) **Join our active support community** - For issues or questions, open an issue in the actor's repository - Check the [SIรN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools - โœ‰๏ธ **Enjoying the actor?** Please leave a โญโญโญโญโญ review on the actor page โ€” it genuinely helps and lets us keep improving it. **More UK-retail scrapers from SIรN Agency:** - [Nike Product Scraper](https://apify.com/sian.agency/nike-product-scraper?fpr=sian) - [Currys Product Scraper](https://apify.com/sian.agency/currys-product-scraper?fpr=sian) - [Tesco Product Scraper](https://apify.com/sian.agency/tesco-product-scraper?fpr=sian) - [Browse all SIรN Agency actors](https://apify.com/sian.agency?fpr=sian) *** **Built by [SIรN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)** # Actor input Schema ## `queries` (type: `array`): ๐Ÿ” **KEYWORD SEARCH:** Free-text Marks & Spencer searches โ€” exactly what you'd type into the marksandspencer.com search bar. ๐Ÿ“ **EXAMPLES:** `cashmere jumper` ยท `midi dress` ยท `school shoes` ยท `bath towels` ยท `silk pillowcase` ๐Ÿ’ก **TIP:** Add one search per line โ€” each runs as its own search and all results land in the same dataset. ๐Ÿ–Š๏ธ **BULK EDIT:** Click "Bulk edit" to paste many searches at once (one per line). โœ… **IMPORTANT:** Provide searches, a department / category, OR M\&S URLs (at least one is needed to have something to scrape). ## `scrapeMode` (type: `string`): โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product. โšก **Overview (fast):** Search / category cards only โ€” id, brand, title, product type, price & was-price, rating & review count, images, colour & size variants, stock and labels. 48 products per page โ€” the fastest and cheapest path. ๐Ÿ”ฌ **Detail (description + material + care specs):** Everything in Overview PLUS the full product description, material / composition, care & attribute specs, every colour and size, the complete image gallery, availability and the ratings breakdown scraped from each product page โ€” all merged into one record. ๐Ÿ’ก **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need descriptions, materials and care data. ## `department` (type: `string`): ๐Ÿฌ **DEPARTMENT (optional):** Browse a whole top-level M\&S department instead of (or alongside) a keyword search. ๐Ÿ“‚ **SUPPORTED:** `women` ยท `men` ยท `kids` ยท `lingerie` ยท `beauty` ยท `home-and-furniture` ยท `flowers-and-plants` ยท `gifts` ๐Ÿ’ก **TIP:** Combine with **Category** below to drill into a specific sub-section. Leave blank if you're only using searches or URLs. ## `category` (type: `string`): ๐Ÿ—‚๏ธ **CATEGORY (optional):** Category subpath under the chosen **Department** โ€” mirrors the M\&S left-hand navigation. ๐Ÿ“ **EXAMPLES:** `dresses` ยท `dresses/midi-dresses` ยท `knitwear` ยท `bedding` ๐Ÿ’ก **TIP:** Requires **Department** to be set. Use the tail of the M\&S category URL (e.g. for `/l/women/dresses/midi-dresses` enter `dresses/midi-dresses`). ## `facets` (type: `array`): ๐ŸŽจ **FACET FILTERS (optional):** M\&S `fs5` facet slugs โ€” colour, size, material or style โ€” applied to your department / category browse, exactly like the site's own filters. ๐Ÿ“ **EXAMPLES:** `blue` ยท `cotton` ยท `midi-dresses` ยท `black` ยท `wool` ๐Ÿ–Š๏ธ **BULK EDIT:** Add one facet slug per line to stack multiple filters. ๐Ÿ’ก **TIP:** Leave empty to include everything. ## `urls` (type: `array`): ๐Ÿ”— **PASTE M\&S URLs (optional):** Paste full Marks & Spencer product-list (PLP) or search URLs to scrape them verbatim โ€” any filters and sorting already in the URL are preserved. ๐Ÿ“ **EXAMPLE:** `https://www.marksandspencer.com/l/women/dresses` ๐Ÿ–Š๏ธ **BULK EDIT:** Add one URL per line to sweep several pages in a single run. ## `sort` (type: `string`): ๐Ÿ”ƒ **RESULT ORDERING:** Order listings using Marks & Spencer's own native sort options โ€” so you get the same ranking real shoppers see. โญ **Relevance** surfaces the best-matching products first ยท ๐Ÿ†• **Newest** first ยท ๐Ÿ”ฅ **Best Selling** ยท ๐Ÿ’ฒ **Price** lowโ†”high ยท ๐ŸŒŸ **Top Rated** by customer rating. ## `minPrice` (type: `integer`): ๐Ÿ’ต **MINIMUM PRICE:** Only return products at or above this price (GBP). Applied client-side after fetching. Leave blank for no lower bound. ## `maxPrice` (type: `integer`): ๐Ÿ’ฐ **MAXIMUM PRICE:** Only return products at or below this price (GBP). Applied client-side after fetching. Leave blank for no upper bound. ## `maxResults` (type: `integer`): ๐Ÿ”ข **RESULT CAP:** Maximum number of products to return across all searches, departments and URLs combined. ๐ŸŽ **TIER-BASED LIMITS:** - **FREE users:** Up to 25 products per run - **PAID users:** Unlimited โ€” scrape entire catalogs in a single run ๐Ÿ’ก **TIP:** Keep this low while you dial in your searches, then raise it once the output looks right. ## Actor input object example ```json { "queries": [ "cashmere jumper" ], "scrapeMode": "overview", "sort": "relevance", "maxResults": 100 } ``` # Actor output Schema ## `marksAndSpencerProducts` (type: `string`): Scraped Marks & Spencer products with prices, was-prices, ratings, colour / size variants, images, material and care specs. # 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 = { "queries": [ "cashmere jumper" ] }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/marks-and-spencer-product-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 = { "queries": ["cashmere jumper"] } # Run the Actor and wait for it to finish run = client.actor("sian.agency/marks-and-spencer-product-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 '{ "queries": [ "cashmere jumper" ] }' | apify call sian.agency/marks-and-spencer-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/marks-and-spencer-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Marks & Spencer Product Scraper", "description": "Scrape Marks & Spencer products โ€” fashion, home & beauty. Search or browse by department, get prices, was-prices, ratings, colour/size variants, images, material & care specs.", "version": "1.0", "x-build-id": "zFPOR7TS6eG1ga4I9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~marks-and-spencer-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-marks-and-spencer-product-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/sian.agency~marks-and-spencer-product-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-marks-and-spencer-product-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/sian.agency~marks-and-spencer-product-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-marks-and-spencer-product-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", "properties": { "queries": { "title": "๐Ÿ” Search Queries", "type": "array", "description": "๐Ÿ” **KEYWORD SEARCH:** Free-text Marks & Spencer searches โ€” exactly what you'd type into the marksandspencer.com search bar.\n\n๐Ÿ“ **EXAMPLES:** `cashmere jumper` ยท `midi dress` ยท `school shoes` ยท `bath towels` ยท `silk pillowcase`\n\n๐Ÿ’ก **TIP:** Add one search per line โ€” each runs as its own search and all results land in the same dataset.\n\n๐Ÿ–Š๏ธ **BULK EDIT:** Click \"Bulk edit\" to paste many searches at once (one per line).\n\nโœ… **IMPORTANT:** Provide searches, a department / category, OR M&S URLs (at least one is needed to have something to scrape).", "default": [ "cashmere jumper" ], "items": { "type": "string" } }, "scrapeMode": { "title": "โš™๏ธ Scrape Mode", "enum": [ "overview", "detail" ], "type": "string", "description": "โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product.\n\nโšก **Overview (fast):** Search / category cards only โ€” id, brand, title, product type, price & was-price, rating & review count, images, colour & size variants, stock and labels. 48 products per page โ€” the fastest and cheapest path.\n\n๐Ÿ”ฌ **Detail (description + material + care specs):** Everything in Overview PLUS the full product description, material / composition, care & attribute specs, every colour and size, the complete image gallery, availability and the ratings breakdown scraped from each product page โ€” all merged into one record.\n\n๐Ÿ’ก **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need descriptions, materials and care data.", "default": "overview" }, "department": { "title": "๐Ÿฌ Department", "type": "string", "description": "๐Ÿฌ **DEPARTMENT (optional):** Browse a whole top-level M&S department instead of (or alongside) a keyword search.\n\n๐Ÿ“‚ **SUPPORTED:** `women` ยท `men` ยท `kids` ยท `lingerie` ยท `beauty` ยท `home-and-furniture` ยท `flowers-and-plants` ยท `gifts`\n\n๐Ÿ’ก **TIP:** Combine with **Category** below to drill into a specific sub-section. Leave blank if you're only using searches or URLs." }, "category": { "title": "๐Ÿ—‚๏ธ Category", "type": "string", "description": "๐Ÿ—‚๏ธ **CATEGORY (optional):** Category subpath under the chosen **Department** โ€” mirrors the M&S left-hand navigation.\n\n๐Ÿ“ **EXAMPLES:** `dresses` ยท `dresses/midi-dresses` ยท `knitwear` ยท `bedding`\n\n๐Ÿ’ก **TIP:** Requires **Department** to be set. Use the tail of the M&S category URL (e.g. for `/l/women/dresses/midi-dresses` enter `dresses/midi-dresses`)." }, "facets": { "title": "๐ŸŽจ Facet Filters", "type": "array", "description": "๐ŸŽจ **FACET FILTERS (optional):** M&S `fs5` facet slugs โ€” colour, size, material or style โ€” applied to your department / category browse, exactly like the site's own filters.\n\n๐Ÿ“ **EXAMPLES:** `blue` ยท `cotton` ยท `midi-dresses` ยท `black` ยท `wool`\n\n๐Ÿ–Š๏ธ **BULK EDIT:** Add one facet slug per line to stack multiple filters.\n\n๐Ÿ’ก **TIP:** Leave empty to include everything.", "items": { "type": "string" } }, "urls": { "title": "๐Ÿ”— M&S URLs", "type": "array", "description": "๐Ÿ”— **PASTE M&S URLs (optional):** Paste full Marks & Spencer product-list (PLP) or search URLs to scrape them verbatim โ€” any filters and sorting already in the URL are preserved.\n\n๐Ÿ“ **EXAMPLE:** `https://www.marksandspencer.com/l/women/dresses`\n\n๐Ÿ–Š๏ธ **BULK EDIT:** Add one URL per line to sweep several pages in a single run.", "items": { "type": "string" } }, "sort": { "title": "๐Ÿ”ƒ Sort Order", "enum": [ "relevance", "new", "best_selling", "price_low", "price_high", "rating" ], "type": "string", "description": "๐Ÿ”ƒ **RESULT ORDERING:** Order listings using Marks & Spencer's own native sort options โ€” so you get the same ranking real shoppers see.\n\nโญ **Relevance** surfaces the best-matching products first ยท ๐Ÿ†• **Newest** first ยท ๐Ÿ”ฅ **Best Selling** ยท ๐Ÿ’ฒ **Price** lowโ†”high ยท ๐ŸŒŸ **Top Rated** by customer rating.", "default": "relevance" }, "minPrice": { "title": "๐Ÿ’ต Min Price (GBP)", "minimum": 0, "type": "integer", "description": "๐Ÿ’ต **MINIMUM PRICE:** Only return products at or above this price (GBP). Applied client-side after fetching. Leave blank for no lower bound." }, "maxPrice": { "title": "๐Ÿ’ฐ Max Price (GBP)", "minimum": 0, "type": "integer", "description": "๐Ÿ’ฐ **MAXIMUM PRICE:** Only return products at or below this price (GBP). Applied client-side after fetching. Leave blank for no upper bound." }, "maxResults": { "title": "๐Ÿ”ข Max Results", "minimum": 1, "type": "integer", "description": "๐Ÿ”ข **RESULT CAP:** Maximum number of products to return across all searches, departments and URLs combined.\n\n๐ŸŽ **TIER-BASED LIMITS:**\n- **FREE users:** Up to 25 products per run\n- **PAID users:** Unlimited โ€” scrape entire catalogs in a single run\n\n๐Ÿ’ก **TIP:** Keep this low while you dial in your searches, then raise it once the output looks right.", "default": 100 } } }, "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 } } } } } } } } } } ```