# Douglas Product Scraper (`sian.agency/douglas-product-scraper`) Actor

Scrape Douglas beauty & cosmetics products — price, ratings, images, ingredients & specs. Keyword search, full detail enrichment, clean JSON/CSV, no code.

- **URL**: https://apify.com/sian.agency/douglas-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.30 / 1,000 overview 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

## Douglas Product Scraper — Beauty Prices, Ingredients & Specs 💄

[![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Google Shopping Price Scraper](https://img.shields.io/badge/Store-Google%20Shopping%20Price%20Scraper-4285F4)](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) [![Home Depot Product Scraper](https://img.shields.io/badge/Store-Home%20Depot%20Product%20Scraper-F96302)](https://apify.com/sian.agency/home-depot-product-scraper?fpr=sian) [![Walmart Product Scraper](https://img.shields.io/badge/Store-Walmart%20Product%20Scraper-0071CE)](https://apify.com/sian.agency/walmart-data-scraper?fpr=sian)

#### 🎉 Pull Douglas prices, discounts, ratings, and full ingredient lists — by keyword, no code
##### Built for beauty analysts, e-commerce sellers, and brands who need fresh Douglas product data on demand

---

### 📋 Overview

**Track every price, discount, and ingredient list on Douglas — without writing a single line of code.** This scraper turns any Douglas (douglas.de) search into a clean, structured spreadsheet of beauty & cosmetics products, complete with EUR prices, ratings, images, classifications, and full INCI ingredient lists.

**Why beauty professionals choose us:**
- ✅ **Complete product data**: 35+ fields per product — price, original price, discount, RRP, base price (€/unit), rating, review count, brand, classification, and more
- ⚡ **Fast search-first mode**: pull up to 48 products per keyword in seconds; scale to thousands across multiple searches
- 🧪 **Ingredient extraction**: get the full INCI ingredients list, usage instructions and EAN in Detail mode
- 💰 **Pay only for results**: charged per product you actually receive — no wasted spend, free tier to test
- 💎 **Detail enrichment**: add the full ingredients list, category trail and long description with one switch
- ✨ **Native sorting**: sort by relevance, price, newest, or top rated — just like the Douglas site

---

### ✨ Features

- 🔎 **Keyword Search**: scrape any Douglas search term across perfume, makeup, skincare, hair and more
- 🏷️ **Full Pricing (EUR)**: current price, original/strikethrough price, discount percentage, RRP (UVP) and base price per unit
- ⭐ **Ratings & Reviews**: star rating and total review count for every product
- 🧪 **Ingredients & Usage**: full INCI ingredients list and how-to-apply text (Detail mode)
- 🖼️ **Product Images**: all product image URLs, ready for catalogs or feeds
- 🧴 **Brand & Product Line**: brand, brand line, and product family for clean classification
- 🧭 **Categories & Classifications**: classification (e.g. Eau de Parfum, Mascara) and the full category trail
- 🔢 **Identifiers**: variant code, base product, EAN barcode, content amount and unit (e.g. 60 ml)
- 📦 **Clean Export**: results delivered as structured JSON or CSV, ready for Excel or your database
- 🚀 **No-Code Setup**: configure searches in a simple form — no scripts, no maintenance

---

### 🎬 Quick Start

Enter one or more search keywords, pick a mode, and run. In under a minute you'll have a structured dataset of Douglas products you can download as JSON or CSV. No setup, no proxies, no code.

```bash
curl -X POST https://api.apify.com/v2/acts/sian.agency~douglas-product-scraper/runs?token=YOUR_TOKEN \
-H 'Content-Type: application/json' \
-d '{"keywords": ["parfum"], "scrapeMode": "overview"}'
````

***

### 🚀 Getting Started (3 Simple Steps)

#### Step 1: Add Your Searches

Type one or more Douglas search keywords (e.g. `parfum`, `mascara`, `gesichtscreme`) — one per line.

#### Step 2: Choose Your Mode

Pick **Overview** for fast search results, or **Detail** to also pull the full ingredients list, usage text and long description.

#### Step 3: Run & Download

Click **Start**, then export your results as JSON, CSV, or Excel from the Apify dataset.

**That's it! In just a few minutes, you'll have:**

- A clean table of Douglas products with EUR prices and discounts
- Ratings, review counts, and product images
- Full ingredients and descriptions (Detail mode)

***

### 📥 Input Configuration

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| keywords | array | No | Douglas search terms, one per item (e.g. `parfum`, `mascara`) |
| productCodes | array | No | Advanced — Douglas product codes (or `/de/p/<code>` URLs) for direct detail lookup |
| scrapeMode | string | No | `overview` (fast search) or `detail` (adds ingredients + long description) |
| sort | string | No | `relevance`, `price_low`, `price_high`, `newest`, or `top_rated` |
| maxResults | integer | No | Maximum products to return across all searches |

**Example — fast search:**

```json
{
  "keywords": ["parfum", "mascara"],
  "scrapeMode": "overview",
  "sort": "relevance",
  "maxResults": 100
}
```

**Example — full detail with ingredients:**

```json
{
  "keywords": ["gesichtscreme"],
  "scrapeMode": "detail",
  "sort": "top_rated",
  "maxResults": 50
}
```

***

### 📤 Output

Results are saved to the Apify dataset with **35+ fields per product**, including:

| Field | Type | Description |
|-------|------|-------------|
| productTitle | string | Product name (brand + line + variant) |
| brand | string | Brand name |
| variant\_name | string | Variant label, e.g. `50 ml` |
| price | number | Current price (EUR) |
| original\_price | number | Strikethrough / was price (EUR) |
| discount\_percentage | number | Discount as a percentage |
| recommended\_retail\_price | number | Manufacturer RRP / UVP (EUR) |
| base\_price | number | Reference price per base unit (e.g. €/litre) |
| rating | number | Average star rating |
| review\_count | number | Total number of reviews |
| classifications | array | Product classifications (e.g. Eau de Parfum) |
| in\_stock | boolean | Whether the product is in stock |
| images | array | All product image URLs |
| ean | string | EAN barcode (Detail mode) |
| breadcrumbs | array | Full category path (Detail mode) |
| ingredients | string | Full INCI ingredients list (Detail mode) |
| application | string | Usage / how-to-apply text (Detail mode) |
| description | string | Long product description (Detail mode) |

**Example:**

```json
{
  "code": "301376",
  "base_product": "2010006632",
  "productTitle": "CHANEL WATERPROOF Noir",
  "brand": "CHANEL",
  "variant_name": "Noir",
  "price": 35.2,
  "original_price": 44.0,
  "currency": "EUR",
  "discount_percentage": 20,
  "rating": 4.3,
  "review_count": 80,
  "classifications": ["Mascara"],
  "in_stock": true,
  "images": ["https://media.douglas.de/medias/..."],
  "ean": "3145891969108",
  "breadcrumbs": ["Make-up", "Augen", "Mascara"],
  "ingredients": "Aqua (Water), Paraffin, Acacia Senegal Gum, ...",
  "description": "Wasserfeste Mascara für intensiven Volumeneffekt..."
}
```

***

### 💼 Use Cases & Examples

#### 1. Price Monitoring

**Retailers and resellers tracking Douglas prices over time to stay competitive.**

**Input:** Your product keywords and a daily schedule
**Output:** Current price, original price, and discount percentage for every match
**Use:** Spot price drops, react to promotions, and keep your own pricing sharp.

#### 2. Competitive Analysis

**Beauty brands and category managers benchmarking their products against the Douglas assortment.**

**Input:** Category keywords (e.g. a brand or product type)
**Output:** Competitor prices, ratings, review counts, and discount activity
**Use:** Understand where you win or lose on price, rating, and assortment.

#### 3. Catalog Building

**E-commerce teams and marketplaces building a clean beauty catalog with images and ingredients.**

**Input:** Keywords in Detail mode
**Output:** Titles, brands, classifications, images, ingredients and full descriptions
**Use:** Populate your storefront or PIM with structured, ready-to-use product data.

#### 4. Ingredient & Formulation Research

**Analysts and formulators extracting INCI ingredient lists across products.**

**Input:** Your product or brand keywords in Detail mode
**Output:** Full INCI ingredients list, usage text and EAN per product
**Use:** Benchmark formulations, build ingredient datasets, and support compliance work.

#### 5. Brand & Assortment Research

**Merchandisers studying which products and lines carry the best ratings and assortment.**

**Input:** Brand or category keywords
**Output:** Brand line, product family, classification, and rating data
**Use:** Plan assortment, track brand lines, and find top-rated products in a category.

#### 6. Market Research & Trend Spotting

**Analysts and researchers tracking new products, best-sellers, and review momentum.**

**Input:** Broad category keywords, sorted by newest or top-rated
**Output:** Product launches, rating trends, and review-count growth
**Use:** Surface emerging products and category trends before competitors do.

***

### 🔗 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/douglas-product-scraper').call({
  keywords: ['parfum'],
  scrapeMode: 'overview'
});

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/douglas-product-scraper').call(
    run_input={'keywords': ['parfum'], 'scrapeMode': 'overview'}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)
```

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~douglas-product-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"keywords": ["parfum"], "scrapeMode": "overview"}'
```

#### Automation Workflows (N8N / Zapier / Make)

1. **Trigger**: Schedule (e.g. daily) or webhook
2. **HTTP Request**: Call the actor API with your keywords
3. **Process**: Handle the JSON results
4. **Action**: Save to a sheet, sync to a database, or send a price-drop alert

***

### 📊 Performance & Pricing

#### FREE Tier (Try It Now)

- **25 products** per run — full feature access, same data quality
- No credit card required
- Perfect for testing and small projects

#### PAID Tier (Production Ready)

- **Unlimited** products per run
- Run multiple searches in one go
- Pay-per-result: you're only charged for the products you actually receive

💰 **Best value on the market** — transparent pay-per-result pricing with no hidden proxy or subscription fees.

🔗 [View current pricing](https://apify.com/sian.agency/douglas-product-scraper?fpr=sian)

***

### ❓ Frequently Asked Questions

**Q: How many products can I scrape?**
A: FREE tier: 25 products per run. PAID tier: unlimited products across as many searches as you like.

**Q: Are prices in euros?**
A: Yes — this scraper targets douglas.de (Germany), so all prices are in EUR.

**Q: What's the difference between Overview and Detail mode?**
A: Overview is the fast path — search results with EUR price, ratings, images, and classification. Detail adds the full INCI ingredients list, usage text, EAN and the long product description for every product.

**Q: Can I look up a specific product directly?**
A: Yes — use the `productCodes` field with one or more Douglas product codes (or full `/de/p/...` links) in Detail mode.

**Q: What output formats are available?**
A: JSON, CSV, and Excel — export directly from the Apify dataset.

**Q: Is this legal?**
A: Yes — we only extract publicly available product data. See the legal section below.

**Q: How fresh is the data?**
A: Every run pulls live data directly from Douglas at the moment you run it. Schedule runs to keep prices and stock up to date.

***

### 🐞 Troubleshooting

**No results returned**

- Check that your keywords match real Douglas products
- Try a broader search term or a different sort order

**Missing ingredients or description**

- Ingredients, usage and long descriptions only appear in **Detail** mode — switch `scrapeMode` to `detail`

**Fewer results than expected on the free tier**

- The FREE tier is capped at 25 products per run — upgrade to PAID for unlimited results

***

### ⚖️ 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 shared. 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. 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 Disclaimer

Douglas® is a trademark of Douglas GmbH. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Douglas GmbH.

***

### ⭐ Love This Tool?

If this actor saves you time, please [leave us a 5-star review](https://apify.com/sian.agency/douglas-product-scraper/reviews) — it helps other professionals discover it and helps us keep improving.

***

### 🤝 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
- 📧 <apify@sian-agency.online>

#### More from SIÁN Agency

- 🛍️ [Google Shopping Price Scraper](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) — track offers and price history across the web
- 🪚 [Home Depot Product Scraper](https://apify.com/sian.agency/home-depot-product-scraper?fpr=sian) — Home Depot prices, specs & store inventory
- 🏪 [Walmart Product Scraper](https://apify.com/sian.agency/walmart-data-scraper?fpr=sian) — Walmart product and review data

***

**Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)**

# Actor input Schema

## `keywords` (type: `array`):

🔍 **KEYWORD SEARCH:** Free-text Douglas searches — exactly what you'd type into the site's search bar.

📝 **EXAMPLES:** `parfum` · `mascara` · `lippenstift` · `gesichtscreme` · `chanel`

💡 **TIP:** Add one keyword per line — each runs as its own search and all results land in the same dataset.

🖊️ **BULK EDIT:** Click "Bulk edit" to paste many keywords at once (one per line).

✅ **IMPORTANT:** Provide either keywords OR product codes (at least one is needed to have something to scrape).

## `productCodes` (type: `array`):

🔢 **DIRECT PRODUCT LOOKUP (Advanced):** Pull full detail for specific products without a search.

🔧 **HOW TO GET IT:** Open any Douglas product page and copy the numeric id from the URL (e.g. the part after `/p/` in `douglas.de/de/p/2001003772`). Paste just that number here — or paste the whole `/de/p/...` link, it's auto-extracted.

💡 **TIP:** Leave this empty if you're only using keywords. Product codes are used in Detail mode to fetch ingredients, usage, EAN and the full description directly.

🖊️ **BULK EDIT:** Add one product code per line to fetch many products in a single run.

## `scrapeMode` (type: `string`):

⚙️ **SCRAPE DEPTH:** Choose how much data to pull per product.

⚡ **Overview (fast):** Search results only — price, ratings, images, brand, product line, classification (e.g. Eau de Parfum) and pack size. Fastest and cheapest path.

🔬 **Detail (enriched):** Everything in Overview PLUS the full INCI ingredients list, usage / how-to-apply text, EAN barcode, category trail, key bullet points and the long product description scraped from each product page.

💡 **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need ingredients or the full spec sheet for feeds or comparisons.

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

🔃 **RESULT ORDERING:** Order search results using Douglas's own native sort options — so you get the same ranking real shoppers see.

🏆 **Relevance** is the site's default ranking · 💲 **Price** sorts ascending or descending · 🆕 **Newest** prioritizes the latest arrivals · ⭐ **Top rated** leads with the highest-reviewed items.

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

🔢 **RESULT CAP:** Maximum number of products to return across all keywords and product codes combined.

🎁 **TIER-BASED LIMITS:**

- **FREE users:** Up to 25 products per run
- **PAID users:** Unlimited — scrape entire result sets in a single run

💡 **TIP:** Keep this low while you dial in your keywords, then raise it once the output looks right.

## Actor input object example

```json
{
  "keywords": [
    "parfum"
  ],
  "scrapeMode": "overview",
  "sort": "relevance",
  "maxResults": 100
}
```

# Actor output Schema

## `douglasProducts` (type: `string`):

Scraped Douglas products with EUR prices, discounts, ratings, images, classifications, ingredients and descriptions.

# 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 = {
    "keywords": [
        "parfum"
    ]
};

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

# Prepare the Actor input
run_input = { "keywords": ["parfum"] }

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/douglas-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 '{
  "keywords": [
    "parfum"
  ]
}' |
apify call sian.agency/douglas-product-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Douglas Product Scraper",
        "description": "Scrape Douglas beauty & cosmetics products — price, ratings, images, ingredients & specs. Keyword search, full detail enrichment, clean JSON/CSV, no code.",
        "version": "1.0",
        "x-build-id": "8ZiZvVMwBzb2Ydj8g"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/sian.agency~douglas-product-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-sian.agency-douglas-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~douglas-product-scraper/runs": {
            "post": {
                "operationId": "runs-sync-sian.agency-douglas-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~douglas-product-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-sian.agency-douglas-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": {
                    "keywords": {
                        "title": "🔍 Search Keywords",
                        "type": "array",
                        "description": "🔍 **KEYWORD SEARCH:** Free-text Douglas searches — exactly what you'd type into the site's search bar.\n\n📝 **EXAMPLES:** `parfum` · `mascara` · `lippenstift` · `gesichtscreme` · `chanel`\n\n💡 **TIP:** Add one keyword 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 keywords at once (one per line).\n\n✅ **IMPORTANT:** Provide either keywords OR product codes (at least one is needed to have something to scrape).",
                        "default": [
                            "parfum"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "productCodes": {
                        "title": "🔢 Product Codes (Advanced)",
                        "type": "array",
                        "description": "🔢 **DIRECT PRODUCT LOOKUP (Advanced):** Pull full detail for specific products without a search.\n\n🔧 **HOW TO GET IT:** Open any Douglas product page and copy the numeric id from the URL (e.g. the part after `/p/` in `douglas.de/de/p/2001003772`). Paste just that number here — or paste the whole `/de/p/...` link, it's auto-extracted.\n\n💡 **TIP:** Leave this empty if you're only using keywords. Product codes are used in Detail mode to fetch ingredients, usage, EAN and the full description directly.\n\n🖊️ **BULK EDIT:** Add one product code per line to fetch many products in a single run.",
                        "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 results only — price, ratings, images, brand, product line, classification (e.g. Eau de Parfum) and pack size. Fastest and cheapest path.\n\n🔬 **Detail (enriched):** Everything in Overview PLUS the full INCI ingredients list, usage / how-to-apply text, EAN barcode, category trail, key bullet points and the long product description scraped from each product page.\n\n💡 **TIP:** Start with Overview to scope your catalog, then switch to Detail when you need ingredients or the full spec sheet for feeds or comparisons.",
                        "default": "overview"
                    },
                    "sort": {
                        "title": "🔃 Sort Order",
                        "enum": [
                            "relevance",
                            "price_low",
                            "price_high",
                            "newest",
                            "top_rated"
                        ],
                        "type": "string",
                        "description": "🔃 **RESULT ORDERING:** Order search results using Douglas's own native sort options — so you get the same ranking real shoppers see.\n\n🏆 **Relevance** is the site's default ranking · 💲 **Price** sorts ascending or descending · 🆕 **Newest** prioritizes the latest arrivals · ⭐ **Top rated** leads with the highest-reviewed items.",
                        "default": "relevance"
                    },
                    "maxResults": {
                        "title": "🔢 Max Results",
                        "minimum": 1,
                        "type": "integer",
                        "description": "🔢 **RESULT CAP:** Maximum number of products to return across all keywords and product codes combined.\n\n🎁 **TIER-BASED LIMITS:**\n- **FREE users:** Up to 25 products per run\n- **PAID users:** Unlimited — scrape entire result sets in a single run\n\n💡 **TIP:** Keep this low while you dial in your keywords, 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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```