# AboutYou Fashion Catalog & Price Scraper (`dataspryva/aboutyou-fashion-catalog-and-price-scraper`) Actor

Search or browse the AboutYou fashion marketplace by keyword, market, or direct product URL and get names, brands, categories, colors, materials, EUR prices, sale status, and images.

- **URL**: https://apify.com/dataspryva/aboutyou-fashion-catalog-and-price-scraper.md
- **Developed by:** [Dataspryva](https://apify.com/dataspryva) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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

## AboutYou Fashion Catalog & Price Scraper

Pull live AboutYou (aboutyou.de) fashion products without a login, cookie or API key. Search by keyword, browse the Women/Men/Kids catalog or any deeper category, or paste exact product links. Every record carries the brand, category path, colors, sizes, current and previous prices, sale status and product images.

### What this actor does

- **Three fetch modes:** keyword search, category browse, or exact product URLs/IDs
- **Server-side filters:** price floor/ceiling, sale-only, new-arrivals-only, minimum discount and category, so filtering happens before rows are counted
- **Client-side refinements:** brand and color substring filters, sold-out exclusion
- **Pagination:** walks AboutYou's result pages until `maxItems` is reached or the catalog is exhausted, with duplicate protection
- **Sort orders:** relevance, price ascending/descending, newest arrivals and biggest discount
- **Price intelligence:** lowest/highest variant price in EUR, previous price and discount percentage when reduced
- **Omit-empty output:** a field appears only when AboutYou actually provides a value

### Output per product

- `productId`, `masterKey`, `referenceKey` — product and style identifiers
- `name`, `brand`, `brandId`, `productType` — product identity
- `category`, `categoryId`, `categoryPath`, `gender` — catalog placement
- `color`, `material`, `pattern`, `description` — attributes
- `priceMin`, `priceMax`, `currency` — current variant price range
- `wasPriceMin`, `onSale`, `discountPercent` — markdown details
- `isNew`, `isSoldOut` — AboutYou product flags
- `sizes` — variant size labels
- `variantCount` — number of variants returned
- `imageUrls`, `image` — up to 10 image URLs and the first image
- `sourceUrl` — product page on aboutyou.de
- `recordType`, `scrapedAt` — record metadata

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | `search`, `browseByCategory` or `byUrl` |
| `searchQuery` | string | `jeans` | Keyword for search mode |
| `category` | string | `frauen` | Top-level section: `frauen`, `maenner`, `kinder` |
| `categoryId` | string | – | Deeper category ID or category URL; overrides `category` |
| `urls` | array | `[]` | Product links or numeric IDs for byUrl mode |
| `priceMin`, `priceMax` | number | – | EUR price band |
| `excludeSoldOut` | boolean | `false` | Drop sold-out products |
| `brand` | string | – | Brand-name substring filter |
| `color` | string | – | Color-label substring filter |
| `saleOnly` | boolean | `false` | Reduced products only |
| `newOnly` | boolean | `false` | New arrivals only |
| `minDiscount` | integer | – | Minimum discount percentage |
| `sort` | string | `relevance` | `relevance`, `price_asc`, `price_desc`, `newest`, `discount` |
| `maxItems` | integer | `100` | Stop after this many matching products (1–10,000) |

#### Example: keyword search with a price band

```json
{
  "mode": "search",
  "searchQuery": "sneakers",
  "priceMin": 30,
  "priceMax": 120,
  "saleOnly": true,
  "sort": "price_asc",
  "maxItems": 50
}
```

#### Example: browse the Women's jeans category

```json
{
  "mode": "browseByCategory",
  "categoryId": "20258",
  "excludeSoldOut": true,
  "sort": "newest",
  "maxItems": 200
}
```

#### Example: look up exact products

```json
{
  "mode": "byUrl",
  "urls": [
    "https://www.aboutyou.de/p/hispanitas/crossbody-bag-32270001",
    "32270001"
  ]
}
```

### Use cases

- **Price monitoring:** track EUR price ranges, discounts and sold-out state for a brand or category
- **Catalog building:** populate a fashion database with names, colors, sizes and images
- **Assortment research:** compare what brands and product types are live in a market section
- **Competitive benchmarking:** compare price positioning across AboutYou listings

### FAQ

**Do I need a login, cookie or proxy?**
No. The actor reads AboutYou's public storefront catalog anonymously and needs no proxy setup.

**Which shop and currency does it use?**
The German AboutYou catalog in EUR. Prices come from the live variant data.

**Why is a price a range?**
A product has several size variants, and their prices can differ. `priceMin` and `priceMax` show the spread.

**Why is `wasPriceMin` sometimes missing?**
It appears only when at least one variant has a previous (pre-sale) price. `discountPercent` is omitted for full-price products.

**Why are some attributes missing?**
AboutYou does not set every attribute on every product. Those fields are omitted rather than sent as null or empty values.

**How many products can I get?**
Up to the `maxItems` you set, capped at 10,000. Results are paginated; the actor stops when the catalog is exhausted or the cap is reached.

**Does it return sold-out products?**
Yes by default, because AboutYou marks them explicitly. Set `excludeSoldOut` to drop them.

**What are the known limits?**
The actor reads the German shop in EUR. Keyword search is full-text, so use category browse for an exact catalog slice. A very large price-sorted run can contain a rare out-of-order row when the live catalog changes between pages; IDs are deduplicated. Brand-new products may not have a public product page yet, so their `sourceUrl` can open the brand shop.

**Is this affiliated with AboutYou?**
No. This is an independent third-party actor that reads public catalog data and is not endorsed by AboutYou.

# Actor input Schema

## `mode` (type: `string`):

Search by keyword, browse a category, or look up exact product URLs.

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

Keyword search such as `jeans`, `sneakers` or `summer dress`. Used by search mode.

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

Top-level shop section used by browse mode. Choose Women, Men or Kids.

## `categoryId` (type: `string`):

Optional deeper category, for example `20258` or `https://www.aboutyou.de/c/women/clothing/jeans-20258`. Overrides the top-level category.

## `urls` (type: `array`):

AboutYou product links or numeric product IDs, used by byUrl mode.

## `priceMin` (type: `number`):

Only keep products whose lowest variant price is at least this amount.

## `priceMax` (type: `number`):

Only keep products whose lowest variant price is at most this amount.

## `excludeSoldOut` (type: `boolean`):

Drop products AboutYou has marked as sold out.

## `brand` (type: `string`):

Keep only products whose brand name contains this text, for example `Levi`.

## `color` (type: `string`):

Keep only products whose color label contains this text, for example `schwarz` or `blue`.

## `saleOnly` (type: `boolean`):

Keep only products that AboutYou has reduced in price.

## `newOnly` (type: `boolean`):

Keep only products AboutYou marks as new.

## `minDiscount` (type: `integer`):

Only keep products whose highest variant discount is at least this percentage.

## `sort` (type: `string`):

Order results by relevance, price, newest arrival or biggest discount.

## `maxItems` (type: `integer`):

Stop after this many matching products.

## Actor input object example

```json
{
  "mode": "search",
  "searchQuery": "jeans",
  "category": "frauen",
  "urls": [],
  "excludeSoldOut": false,
  "saleOnly": false,
  "newOnly": false,
  "sort": "relevance",
  "maxItems": 3
}
```

# Actor output Schema

## `items` (type: `string`):

Dataset containing all scraped AboutYou product records.

# 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 = {
    "mode": "search",
    "searchQuery": "jeans",
    "category": "frauen",
    "urls": [],
    "excludeSoldOut": false,
    "saleOnly": false,
    "newOnly": false,
    "sort": "relevance",
    "maxItems": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("dataspryva/aboutyou-fashion-catalog-and-price-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 = {
    "mode": "search",
    "searchQuery": "jeans",
    "category": "frauen",
    "urls": [],
    "excludeSoldOut": False,
    "saleOnly": False,
    "newOnly": False,
    "sort": "relevance",
    "maxItems": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("dataspryva/aboutyou-fashion-catalog-and-price-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",
  "searchQuery": "jeans",
  "category": "frauen",
  "urls": [],
  "excludeSoldOut": false,
  "saleOnly": false,
  "newOnly": false,
  "sort": "relevance",
  "maxItems": 3
}' |
apify call dataspryva/aboutyou-fashion-catalog-and-price-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dataspryva/aboutyou-fashion-catalog-and-price-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/TOJCbbchqTrAOQ33e/builds/GyMQaCOqdPALQGGBu/openapi.json
