# Stella McCartney Scraper (`aboo.script/stellamccartney-scraper`) Actor

⚡ Fast Stella McCartney scraper for stellamccartney.com. No login, no API key. Scrape bags, ready-to-wear, shoes, kids and sale items by keyword, category, search or product URL in 78 country stores with prices, sale prices, stock per size, colors, composition and images.

- **URL**: https://apify.com/aboo.script/stellamccartney-scraper.md
- **Developed by:** [Aboo Script](https://apify.com/aboo.script) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 1,000 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?

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

## Stella McCartney Scraper

![Stella McCartney Scraper](https://i.ibb.co/FGQd76K/stellamccartney-banner.png)

**Stella McCartney Scraper** extracts official Stella McCartney products from [stellamccartney.com](https://www.stellamccartney.com/) into clean, structured data you can download as JSON, CSV, Excel, or HTML. Paste a category, search, or product URL, or type a few keywords, and get the product name, product code, price and sale price, currency, colors, sizes with stock, composition, description, and images for every product. Works for all 78 country stores of the website, with no account or login required.

### Introduction

[Stella McCartney](https://www.stellamccartney.com/) is the official online store of the British luxury fashion house known for its vegan, cruelty-free designs: the iconic Falabella bags, ready-to-wear, shoes, accessories, kids' clothing, and the adidas by Stella McCartney line. The website runs a separate store for 78 countries and languages, each with its own prices, currency, and product availability.

This actor collects the same public information you see in your browser and turns it into a ready-to-use dataset. You can run it once, schedule it to run daily to follow prices, sales, and stock, or connect it to your own tools.

### What data can you extract from Stella McCartney?

- 🏷️ Product name, product code, master code, and SKU
- 🗂️ Category, subcategory (for example Tote Bags or Knitwear), and category path
- 💲 Price as a number, original price for sale items, formatted price, and currency of the selected country
- 🔥 Sale flag for discounted products
- 📦 Availability and stock for every size, including low-stock sizes
- 🎨 Product color and all other colors with their color codes and links
- 🧵 Composition (materials)
- 📝 Full description, product details list, and extra sections such as sustainability and care & fit advice
- 🖼️ Main image and all product images
- 🌍 Country store (market) and direct product URL

### Use Cases

- 📈 **Market research**: compare Stella McCartney prices across countries and currencies, and follow new arrivals.
- 🏷️ **Sale tracking**: find discounted products with their original and sale prices.
- 🕵️ **Competitor monitoring**: track which products, colors, and sizes are in stock, running low, or sold out.
- 🌱 **Sustainability research**: collect materials, compositions, and sustainability notes of a vegan luxury brand.
- 🤖 **AI and automation**: feed clean, structured data into spreadsheets, dashboards, or AI workflows.

### How to scrape Stella McCartney step by step

1. Paste one or more stellamccartney.com URLs into **Start URLs**, or type keywords into **Search queries**.
2. For search queries, choose the **Market** (country store) and, if you like, the sort order and price range.
3. Set **Maximum number of results** to how many products you want per URL or per query.
4. Click **Start** and wait for the run to finish.
5. Download your data in JSON, CSV, Excel, or HTML from the **Output** tab.

### Input

- **Start URLs**: stellamccartney.com URLs to scrape. Supported pages: category pages (such as `https://www.stellamccartney.com/us/en/women/handbags`), search pages (such as `https://www.stellamccartney.com/us/en/search?q=dress`), and single product pages. The country, language, and currency follow the URL, and any filters or sort order you apply on the website are kept in the results.
- **Search queries**: keywords to search on stellamccartney.com, one per line. Each query is scraped separately.
- **Maximum number of results**: how many products to collect for each start URL or search query. Use 0 for no limit.
- **Market**: the country store used for search queries. It sets the currency and the language of product texts.
- **Sort by**: order of the search results (most relevant, best sellers, newest, price low to high, price high to low). Applies to search queries only.
- **Minimum price** and **Maximum price**: price range in the currency of the selected market. Apply to search queries only.

You can use start URLs, search queries, or both in the same run.

### Input Examples

Scrape a category page:

```json
{
  "startUrls": [{ "url": "https://www.stellamccartney.com/us/en/women/handbags" }],
  "maxResults": 5
}
```

Search by keywords in the United States store:

```json
{
  "searchQueries": ["falabella", "dress"],
  "market": "us/en",
  "sortBy": "relevance",
  "maxResults": 5
}
```

### Output

Each product color is saved as one item in the dataset. Here is an example of a single item:

```json
{
  "url": "https://www.stellamccartney.com/us/en/sale/archive-sale/falabella-loafers-810298AP02101000.html",
  "productId": "810298AP02101000",
  "masterId": "810298AP0210",
  "sku": "810298AP02101000",
  "name": "Falabella Loafers",
  "brand": "Stella McCartney",
  "category": "Archive Sale",
  "subcategory": "Casual Shoes",
  "categoryPath": ["Sale", "Archive Sale"],
  "color": "Black",
  "price": 645,
  "listPrice": 860,
  "priceFormatted": "$645.00",
  "currency": "USD",
  "onSale": true,
  "inStock": true,
  "availability": "In Stock",
  "sizes": [
    { "size": "35", "inStock": true, "lowStock": false },
    { "size": "35h", "inStock": false, "lowStock": false },
    { "size": "38", "inStock": true, "lowStock": true },
    { "size": "41", "inStock": false, "lowStock": false }
  ],
  "colors": [
    {
      "color": "Black",
      "colorCode": "1000",
      "url": "https://www.stellamccartney.com/us/en/sale/archive-sale/falabella-loafers-810298AP02101000.html?dwvar_810298AP02101000_color=1000",
      "selected": true
    },
    {
      "color": "Ivory",
      "colorCode": "9002",
      "url": "https://www.stellamccartney.com/us/en/sale/archive-sale/falabella-loafers-810298AP02101000.html?dwvar_810298AP02101000_color=9002",
      "selected": false
    }
  ],
  "description": "Borrowing from menswear aesthetics, our Falabella loafers are refreshed with saddle stitching around the midsole and a slim iconic Falabella chain. The loafers feaute our iconic angular square toe.",
  "details": [
    "Colour: Black",
    "Alter Mat vegan alternative to animal leather",
    "Silver Falabella diamond-cut recycled brass chain around heel",
    "Angular square toe",
    "Made in Italy"
  ],
  "composition": "65% polyurethane, 35% polyester",
  "infoSections": [
    {
      "title": "Sustainability",
      "text": "These Falabella loafers are made with production offcuts in the counter lining. The chain is recycled brass. The sole has recycled rubber."
    },
    {
      "title": "Product Care & Fit Advice",
      "text": "Care: Spot clean only with soft damp cloth\nComposition: Upper: 65% polyurethane, 35% polyester\n20mm sole\nFits true to size"
    }
  ],
  "mainImage": "https://www.stellamccartney.com/dw/image/v2/BCWD_PRD/on/demandware.static/-/Sites-master_catalog/default/dwffc19e1a/Assets/810298AP02101000_X/large/3/8/a/f/38af55f4bfda07a730bd1b388f276d93f422e295_810298AP02101000_X.jpg",
  "images": [
    "https://www.stellamccartney.com/dw/image/v2/BCWD_PRD/on/demandware.static/-/Sites-master_catalog/default/dwffc19e1a/Assets/810298AP02101000_X/large/3/8/a/f/38af55f4bfda07a730bd1b388f276d93f422e295_810298AP02101000_X.jpg",
    "https://www.stellamccartney.com/dw/image/v2/BCWD_PRD/on/demandware.static/-/Sites-master_catalog/default/dw5362d111/Assets/810298AP02101000_j/large/e/f/f/4/eff41ba50e94ae64865e00aa2a5dbd0385321dd5_810298AP02101000_j.jpg"
  ],
  "market": "us/en"
}
```

You can download the dataset in JSON, CSV, Excel, XML, or HTML, or access it through the Apify API.

### Notes

- Each color of a product has its own page on the website, so each color is a separate item. Other colors are listed in `colors` with their links.
- Product names, descriptions, details, section titles, and the category path use the language of the country store.
- Prices, sales, and stock differ by country. Use a URL of the country you need, or pick the **Market** for search queries.
- Some keywords open a category page on the website (for example "falabella" opens The Iconic Falabella page). The actor then returns the products of that page.
- `listPrice` is only filled for discounted products. `sizes` is empty for one-size products such as bags.
- Only stellamccartney.com category, search, and product pages are supported. Country home pages, account pages, and other websites are skipped, and products that are no longer online are skipped after a few attempts.

### Why use the Stella McCartney Scraper?

- ✅ **No login needed**: works with public data only, so there is no account to manage.
- 🌍 **Every country store**: prices and stock for 78 country and language stores in their own currency.
- 🎯 **Keeps your filters**: paste any category or search URL from your browser and get exactly what you see there.
- 📦 **Stock per size**: see which sizes are available or running low, not only whether the product is in stock.
- 🧹 **Clean data**: prices are real numbers, and descriptions and compositions are plain text.
- 💸 **Pay for what you need**: set a result limit per URL or query and keep every run small and cheap.

### FAQ

#### How many results can I scrape?

You can set any number in **Maximum number of results**, or 0 for no limit. The actor keeps going until it reaches your limit or the last product of the page.

#### Do I need a Stella McCartney account?

No. The actor only collects publicly available data. You do not need to log in or provide any account details.

#### Can I scrape data on a schedule?

Yes. Use Apify Schedules to run the actor every hour, day, or week, and follow prices, sales, and stock automatically.

#### Why are some fields empty?

Some products simply do not show every piece of information, for example a description or a composition. When a field is not available on the website, it is returned as `null`.

#### Can I request a new feature or filter?

Yes. Right now the actor supports start URLs, search queries, market, sort order, and price range. If you need other filters or inputs, get in touch and they can be added.

#### Can I get a custom or private version?

Yes. The actor can be customized for your workflow, delivered as a private version, or a new scraper can be built for a different website. Use the contact details below.

***

**Need help or want a custom solution?**

- 📧 Email: aboo.script@gmail.com
- 🧩 More scrapers: [Apify profile](https://apify.com/aboo.script)

### Image Credit

Image credit: [Stella McCartney](https://www.stellamccartney.com/)

# Actor input Schema

## `startUrls` (type: `array`):

stellamccartney.com URLs: categories (https://www.stellamccartney.com/us/en/women/handbags), search pages (https://www.stellamccartney.com/us/en/search?q=dress) or product pages. The market (country, language and currency) follows the URL, and filters and sorting in the URL are applied.

## `searchQueries` (type: `array`):

Keywords to search on stellamccartney.com (e.g. falabella, dress). Each query is scraped separately.

## `maxResults` (type: `integer`):

Maximum number of products to scrape per start URL or search query. Use 0 for no limit.

## `market` (type: `string`):

Country and language of the website used for search queries. It sets the currency and the product texts. Start URLs use the market of the URL.

## `sortBy` (type: `string`):

Order of the search results. Applies to search queries only; start URLs keep their own sorting.

## `minPrice` (type: `integer`):

Only products priced at or above this amount, in the currency of the selected market. Applies to search queries only.

## `maxPrice` (type: `integer`):

Only products priced at or below this amount, in the currency of the selected market. Applies to search queries only.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.stellamccartney.com/us/en/women/handbags"
    }
  ],
  "maxResults": 5,
  "market": "us/en",
  "sortBy": "relevance"
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.stellamccartney.com/us/en/women/handbags"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("aboo.script/stellamccartney-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "startUrls": [{ "url": "https://www.stellamccartney.com/us/en/women/handbags" }] }

# Run the Actor and wait for it to finish
run = client.actor("aboo.script/stellamccartney-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 '{
  "startUrls": [
    {
      "url": "https://www.stellamccartney.com/us/en/women/handbags"
    }
  ]
}' |
apify call aboo.script/stellamccartney-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aboo.script/stellamccartney-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 <APIFY_API_TOKEN>` 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/HCPoly8LM0yqHk37J/builds/OOW5R1YoLhUxNSXe4/openapi.json
