# Zalando Scraper (`unfenced-group/zalando-scraper`) Actor

Scrape Zalando fashion listings across 7 European markets (DE, NL, FR, IT, ES, BE, UK). Get product names, brands, current and original prices, discount percentages, sizes, stock status and images for price tracking, competitor analysis and market research. Search by category or keyword.

- **URL**: https://apify.com/unfenced-group/zalando-scraper.md
- **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.30 / 1,000 products

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.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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

## Zalando Scraper

Scrape Zalando fashion listings across 7 European markets in one run. Get product names, brands, current and original prices, discount percentages, sizes, stock status, and images — sourced directly and returned as clean structured data.

### What it does

- Scrapes any Zalando category or search across **Germany, Netherlands, France, Italy, Spain, Belgium, and the United Kingdom**
- Returns full pricing detail: current price, original price, and calculated discount percentage
- Captures available sizes and live stock status per product
- Optional detail enrichment for color and description
- Works by category slug, free-text search, or pasted Start URLs

### Markets

| Market | Storefront |
|--------|-----------|
| Germany | zalando.de |
| Netherlands | zalando.nl |
| France | zalando.fr |
| Italy | zalando.it |
| Spain | zalando.es |
| Belgium | zalando.be |
| United Kingdom | zalando.co.uk |

### Input

| Field | Type | Description |
|-------|------|-------------|
| `market` | string | Storefront to scrape. One of de, nl, fr, it, es, be, gb. Ignored when Start URLs are set. |
| `category` | string | Category slug, e.g. `herrenschuhe-sneaker`. |
| `searchQuery` | string | Free-text keyword search, used when no category is set. |
| `startUrls` | array | Zalando category or search URLs. Overrides market/category/search; market auto-detected per URL. |
| `maxResults` | integer | Maximum products to return. Set to `0` for unlimited. Default 5. |
| `fetchDetails` | boolean | Visit each product page for color and description. Default false. Off by default for good reason — see note below. |

> **Note on `fetchDetails`.** Leaving this off is the right choice for almost every use case. A listing page returns roughly 24 products in a single request. Turning on `fetchDetails` makes one extra request per product, which is far slower and consumes much more proxy and compute. Only enable it when you specifically need the colour and full description fields and are working with small result sets.

### Output

#### Always present

| Field | Type | Description |
|-------|------|-------------|
| `sku` | string | Zalando product identifier. |
| `name` | string | Product name. |
| `brand` | string | Brand name. |
| `priceCurrent` | number | Current selling price. |
| `priceOriginal` | number | Original price before discount. |
| `currency` | string | Currency code (EUR or GBP). |
| `discountPercent` | number | Discount percentage, 0 if not on sale. |
| `sizes` | array | Available sizes. |
| `inStock` | boolean | True when at least one size is available. |
| `productType` | string | Product group, e.g. shoe, clothing. |
| `url` | string | Product page URL. |
| `images` | array | Product image URLs. |
| `flags` | array | Marketing flags such as new or sustainable. |
| `market` | string | Market code the product was scraped from. |
| `source` | string | Source storefront domain. |
| `scrapedAt` | string | ISO 8601 timestamp of scrape. |

#### With `fetchDetails: true`

| Field | Type | Description |
|-------|------|-------------|
| `color` | string | Product color. |
| `description` | string | Product description text. |

#### Example record

```json
{
  "sku": "NI112O0AB-A11",
  "name": "Air Max 90 - Sneaker low",
  "brand": "Nike Sportswear",
  "priceCurrent": 104.95,
  "priceOriginal": 149.95,
  "currency": "EUR",
  "discountPercent": 30,
  "sizes": ["41", "42", "43", "44", "45"],
  "inStock": true,
  "productType": "shoe",
  "url": "https://www.zalando.de/nike-sportswear-air-max-90-sneaker-low-ni112o0ab-a11.html",
  "images": ["https://img01.ztat.net/article/spp-media-p1/abc.jpg"],
  "flags": ["sustainable"],
  "market": "de",
  "source": "zalando.de",
  "scrapedAt": "2026-06-20T19:00:00.000Z"
}
````

### Examples

**Scrape men's sneakers in Germany**

```json
{ "market": "de", "category": "herrenschuhe-sneaker", "maxResults": 100 }
```

**Search for running shoes in the UK**

```json
{ "market": "gb", "searchQuery": "running shoes", "maxResults": 50 }
```

**Scrape from pasted URLs across markets**

```json
{ "startUrls": [{ "url": "https://www.zalando.nl/dameskleding-jurken/" }, { "url": "https://www.zalando.fr/chaussures-femme/" }], "maxResults": 200 }
```

**Daily price-tracking feed with full detail**

```json
{ "market": "de", "category": "damenschuhe", "maxResults": 0, "fetchDetails": true }
```

### 💰 Pricing

**$1.49 per 1,000 results** — you only pay for successfully retrieved products. Failed retries are never charged.

| Results | Cost |
|---------|------|
| 1,000 | $1.49 |
| 10,000 | $14.90 |
| 100,000 | $149.00 |

***

### Need a custom scraper?

**[Unfenced Group](https://www.unfencedgroup.nl)** builds Apify actors for any website — for free.

If the site you need isn't in our portfolio yet, just ask. We scope, build, and publish it at no cost to you. You only pay for results — we absorb the compute and proxy costs ourselves. Same pay-per-result pricing, same quality, same standards as every actor in this portfolio.

**Get in touch:** [www.unfencedgroup.nl](https://www.unfencedgroup.nl)

# Actor input Schema

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

Zalando storefront to scrape. Ignored when Start URLs are provided.

## `category` (type: `string`):

Catalog category slug, e.g. herrenschuhe-sneaker. Leave empty to use a search query instead.

## `searchQuery` (type: `string`):

Free-text keyword search. Used when no category slug is set.

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

Zalando category or search URLs. Overrides Market/Category/Search. Market is auto-detected from each URL's domain.

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

Maximum number of products to return. Set to 0 for unlimited.

## `fetchDetails` (type: `boolean`):

Visit each product page for extra fields (color, description). Off by default. This makes one request per product instead of ~24 products per listing request, so it is much slower and far more resource-intensive. Only enable for small result sets where you specifically need color and description.

## `proxyConfiguration` (type: `object`):

Residential proxy required — Zalando blocks datacenter IPs.

## Actor input object example

```json
{
  "market": "de",
  "category": "herrenschuhe-sneaker",
  "searchQuery": "running shoes",
  "maxResults": 5,
  "fetchDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (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 = {
    "searchQuery": "nike sneaker",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("unfenced-group/zalando-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 = {
    "searchQuery": "nike sneaker",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("unfenced-group/zalando-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 '{
  "searchQuery": "nike sneaker",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call unfenced-group/zalando-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=unfenced-group/zalando-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Zalando Scraper",
        "description": "Scrape Zalando fashion listings across 7 European markets (DE, NL, FR, IT, ES, BE, UK). Get product names, brands, current and original prices, discount percentages, sizes, stock status and images for price tracking, competitor analysis and market research. Search by category or keyword.",
        "version": "0.0",
        "x-build-id": "nYDaF6AcVdVBVHNJg"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/unfenced-group~zalando-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-unfenced-group-zalando-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/unfenced-group~zalando-scraper/runs": {
            "post": {
                "operationId": "runs-sync-unfenced-group-zalando-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/unfenced-group~zalando-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-unfenced-group-zalando-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": {
                    "market": {
                        "title": "Market",
                        "enum": [
                            "de",
                            "nl",
                            "fr",
                            "it",
                            "es",
                            "be",
                            "gb"
                        ],
                        "type": "string",
                        "description": "Zalando storefront to scrape. Ignored when Start URLs are provided.",
                        "default": "de"
                    },
                    "category": {
                        "title": "Category slug",
                        "type": "string",
                        "description": "Catalog category slug, e.g. herrenschuhe-sneaker. Leave empty to use a search query instead."
                    },
                    "searchQuery": {
                        "title": "Search query",
                        "type": "string",
                        "description": "Free-text keyword search. Used when no category slug is set.",
                        "default": "nike sneaker"
                    },
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "Zalando category or search URLs. Overrides Market/Category/Search. Market is auto-detected from each URL's domain.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "maxResults": {
                        "title": "Max results",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of products to return. Set to 0 for unlimited.",
                        "default": 5
                    },
                    "fetchDetails": {
                        "title": "Fetch product details",
                        "type": "boolean",
                        "description": "Visit each product page for extra fields (color, description). Off by default. This makes one request per product instead of ~24 products per listing request, so it is much slower and far more resource-intensive. Only enable for small result sets where you specifically need color and description.",
                        "default": false
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Residential proxy required — Zalando blocks datacenter IPs.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
