# OTTO.de Scraper - Products, Prices, Variants & Reviews (`abotapi/otto-de-scraper`) Actor

Scrape OTTO.de products by search or URL. Extract prices, discounts, variants, availability, brand, seller, EAN/GTIN, specifications, categories, and customer reviews across fashion, furniture, electronics, and homeware.

- **URL**: https://apify.com/abotapi/otto-de-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

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

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## OTTO Product Scraper

Pull rich product data from OTTO.de, Germany's major general-retail marketplace: fashion, furniture (Möbel), technik, household appliances and more. Search by keyword or category, or paste product and listing links directly. Every record includes the current price, the strike-through original price with computed discount when a product is marked down, the full colour/size variant matrix with per-variant availability, brand, seller identity, and native customer reviews.

### Why This Scraper?

- **Was-price and discount, structured, not scraped from a badge.** When a product carries a reduced price, both the current and original price are captured plus the computed discount percentage and the site's own promo label -- all from the listing fetch, zero extra cost.
- **Full colour/size variant matrix.** Every colour or size option a product offers is returned with its own variation id and availability, exactly as the site's own selector shows it.
- **Specials, first-class.** A `specialsOnly` toggle narrows any search to only products currently showing a reduced price, and `sortBy: DISCOUNT` surfaces the biggest reductions first -- both drive the site's own live discount signal, not a guessed category.
- **Seller transparency.** OTTO is a marketplace: every product's seller is captured, distinguishing OTTO itself from third-party marketplace partners, with the partner's own identifier.
- **Native review history.** Overall rating, review count, and every individual review with author, location, date, star rating, verified-purchase flag, body text, and helpful-vote counts -- sourced directly from the site, not a third-party review widget.
- **Rich detail on demand.** Full breadcrumb category path, flattened technical specifications (varies per product category, never hardcoded), EAN/GTIN/SKU, full image gallery, and return policy.
- **Two ways in, one set of filters.** Keyword or category search, or paste any product/search/category listing link -- brand, rating, price range, specials and sort narrow the results either way (a single pasted product link is a special case, see Input Parameters below).
- **Full-catalogue walk.** `maxPages` is 0 (unlimited) by default -- the run walks every result page for a search/category/URL entry until the site's own last page, `maxItems`, or a run out of new products. Set `maxPages` to a positive number only if you want to cap it.
- **Resume a previous run.** Paste a prior run or dataset id into `resumeFromRunId` to continue it: already-collected products are skipped, so the run returns only new products (a delta) instead of a full re-scrape.
- **Incremental changes for scheduled monitoring.** Turn on `incrementalMode` and re-run the same search daily/weekly: the actor remembers what it saw last time and returns only `NEW`, `UPDATED`, and `REAPPEARED` products by default, marking each with `changeType`, `changedFields`, `firstSeenAt`, and `lastSeenAt`. Optional `emitUnchanged`/`emitExpired` toggles return (and bill) the full snapshot or expiry rows too. This is a different feature from `resumeFromRunId`: Resume continues one specific interrupted run, Incremental mode tracks the same search across many separate scheduled runs.
- **Survives interruption.** Long unlimited-page runs checkpoint their progress; if the run is interrupted by an Apify platform migration or resumed via the Resurrect button, it picks up where it left off with no duplicate products and no double charges.
- **Optional export to your apps.** Send results into Notion, Linear, Airtable, or any Apify MCP connector alongside the dataset.

### Data You Get

| Field | Example value |
|---|---|
| productId / variationId / articleNumber | `S0AB12CD`, `S0AB12CD4XYZ`, `S0AB12CDKIE` |
| name | `Sample Brand Ecksofa, Sofa L-Form, mit Schlaffunktion` |
| brand | `Sample Brand` |
| category / breadcrumb | `Ecksofas`, `[{"name": "Möbel", "url": "..."}, {"name": "Sofas", "url": "..."}, {"name": "Ecksofas", "url": "..."}]` |
| url | `https://www.otto.de/p/sample-ecksofa-S0AB12CD/` |
| price / currency | `799.00`, `EUR` |
| originalPrice / discountPercent / promoLabel | `1599.00`, `50`, `-50%` |
| isOnSpecial | `true` |
| availability / availabilityText | `AVAILABLE`, `lieferbar in 5 Wochen` |
| rating / reviewCount | `4.5`, `26` |
| variants\[] | `[{"variationId": "S0AB12CD4XYZ", "color": "Khaki", "hexCode": "BEB2A9", "selected": true}, {"variationId": "S0AB12CD55VQ", "color": "Gold", "hexCode": "BEB2A8", "selected": false}]` |
| image / images | `["https://sample.example/img1.jpg", "https://sample.example/img2.jpg"]` |
| ean / gtin / sku | `4068181820000`, `4068181820000`, `S0AB12CD4XYZ` |
| specs | `{"Höhe": "85 cm", "Breite": "289 cm", "Polsterung": "Schaumstoff", "Design": "Modern"}` (flattened, varies per category) |
| seller | `{"name": "Sample Home Brands GmbH", "partnerId": "1000000", "sellerType": "MARKETPLACE_PARTNER"}` |
| returnPolicy | `{"days": 30, "freeReturn": true}` |
| reviews.averageRating / reviews.reviewCount | `4.5`, `26` |
| reviews.items\[] | `[{"reviewId": "sample-uuid", "author": "Sample R.", "location": "Sample City", "date": "11.04.2026", "rating": 5, "verifiedPurchase": true, "title": null, "body": "Sample review text.", "helpfulVotes": 5, "helpfulVotesTotal": 5, "variantPurchased": "Farbe: Khaki", "seller": "Sample Home Brands GmbH"}]` |
| changeType / changedFields / firstSeenAt / lastSeenAt | `"UPDATED"`, `["price"]`, `"2026-08-01T00:00:00Z"`, `"2026-08-17T00:00:00Z"` (incremental mode only) |

> Sample shape: values above are illustrative placeholders, not from a live product.

### How to Use

**1. Keyword search, first page, with reviews (default):**

```json
{
  "mode": "search",
  "searchTerm": "ecksofa",
  "maxItems": 20
}
```

**2. Category-style search, filtered to specials and sorted by biggest discount:**

```json
{
  "mode": "search",
  "searchTerm": "sofas",
  "specialsOnly": true,
  "sortBy": "DISCOUNT",
  "maxItems": 50,
  "maxPages": 5
}
```

**3. Full product detail + reviews for pasted product links:**

```json
{
  "mode": "url",
  "urls": ["https://www.otto.de/p/sample-ecksofa-S0AB12CD/"],
  "fetchDetails": true,
  "fetchReviews": true,
  "maxReviewsPerProduct": 0
}
```

**4. Paste a listing link and keep paginating forward:**

```json
{
  "mode": "url",
  "urls": ["https://www.otto.de/suche/ecksofa/"],
  "maxItems": 100,
  "maxPages": 10
}
```

### Input Parameters

| Parameter | Type | Description |
|---|---|---|
| `mode` | string | `search` or `url`. |
| `searchTerm` | string | Keyword or category name (search mode only). |
| `urls` | array | Product or listing URLs to scrape (url mode only). |
| `specialsOnly` | boolean | Keep only currently-discounted products. Applies to a keyword search and a pasted search/category URL. Also evaluated on a single pasted product URL, but the detail page never exposes special-offer status -- so it ALWAYS excludes a pasted product link, on-special or not. Leave it off when pasting a single product URL. |
| `brands` | array | Exact brand names to keep. Applies to a keyword search, a pasted search/category URL, and a single pasted product URL. |
| `minRating` | integer | 1-5, minimum rating to keep. Applies to a keyword search, a pasted search/category URL, and a single pasted product URL. |
| `minPrice` / `maxPrice` | number | EUR price band to keep. Applies to a keyword search, a pasted search/category URL, and a single pasted product URL. |
| `sortBy` | string | `RELEVANCE`, `PRICE_ASC`, `PRICE_DESC`, `DISCOUNT`, `NEWEST`, or `RATING`. Applies to a keyword search and a pasted search/category URL; has no effect on a single pasted product URL (nothing to reorder). |
| `fetchDetails` | boolean | Fetch full product detail (breadcrumb, specs, seller, EAN/GTIN/SKU, return policy). A pasted product URL always fetches its detail page regardless of this toggle, since that is the only source of its data. |
| `fetchReviews` | boolean | Fetch native customer reviews. |
| `maxReviewsPerProduct` | integer | Cap on reviews per product; `0` = all the product page renders. |
| `maxPages` | integer | Cap on result-page fetches per search/URL entry; `0` (default) = unlimited, walks the full catalogue until the site's own last page or Max products total. |
| `maxItems` | integer | Cap on total products returned; `0` = unlimited. |
| `resumeFromRunId` | string | Paste a previous run id (or its dataset id) to continue that run: products already collected there are skipped, so this run only returns new products (a delta). Leave empty for a normal run. For recurring monitoring of the same search, use `incrementalMode` instead. |
| `incrementalMode` | boolean | Off by default. Turn on for daily/recurring monitoring of the same search or URL set: the actor remembers the previous run's products itself and classifies each result `NEW`, `UPDATED`, `UNCHANGED`, `REAPPEARED`, or `EXPIRED`. |
| `stateKey` | string | Optional, incremental mode only. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Leave empty to derive a key automatically from the search/URL and detail settings. |
| `emitUnchanged` | boolean | Off by default, incremental mode only. Also return (and bill) products that have not changed since the last run. |
| `emitExpired` | boolean | Off by default, incremental mode only. Also return (and bill) products present in a previous run but no longer found. Only produced once a run fully scans the tracked search (not when Max products capped it or Resume was used). |
| `proxy` | object | Apify proxy configuration for the listing route. Product detail/reviews always use residential regardless of this setting. |
| `mcpConnectors` | array | Optional MCP connectors to export results into (Notion, Linear, Airtable, Apify). |
| `notionParentPageUrl` | string | Notion connector only: page under which item pages are created. |
| `maxNotifyListings` | integer | Cap on items exported to each connector per run. Does not affect the dataset. |

### Output Example

```json
{
  "productId": "S0AB12CD",
  "variationId": "S0AB12CD4XYZ",
  "articleNumber": "S0AB12CDKIE",
  "name": "Sample Brand Ecksofa, Sofa L-Form, mit Schlaffunktion",
  "brand": "Sample Brand",
  "category": "Ecksofas",
  "url": "https://www.otto.de/p/sample-ecksofa-S0AB12CD/",
  "price": 799.00,
  "currency": "EUR",
  "originalPrice": 1599.00,
  "discountPercent": 50,
  "isOnSpecial": true,
  "availability": "AVAILABLE",
  "rating": 4.5,
  "reviewCount": 26,
  "variants": [
    { "variationId": "S0AB12CD4XYZ", "color": "Khaki", "hexCode": "BEB2A9", "selected": true }
  ],
  "image": "https://sample.example/img1.jpg",
  "reviews": {
    "averageRating": 4.5,
    "reviewCount": 26,
    "items": [
      {
        "reviewId": "sample-uuid",
        "author": "Sample R.",
        "location": "Sample City",
        "date": "11.04.2026",
        "rating": 5,
        "verifiedPurchase": true,
        "body": "Sample review text.",
        "helpfulVotes": 5,
        "helpfulVotesTotal": 5,
        "variantPurchased": "Farbe: Khaki",
        "seller": "Sample Home Brands GmbH"
      }
    ]
  }
}
```

> Sample shape: values above are illustrative placeholders, not from a live product.

### Send results into your apps (MCP connectors)

Optionally pipe results into the apps you already use through Model Context Protocol (MCP) connectors. Authorize a connector once under Apify, Settings, Integrations, then select it in the `mcpConnectors` field. Each connector receives a condensed, human-readable summary per product (title plus key fields), while the complete record always stays in the Apify dataset. For Notion, set `notionParentPageUrl` to the page the item pages should be created under, and use `maxNotifyListings` to cap how many items are exported per connector per run. Supported connectors: Notion, Linear, Airtable, and Apify. Leave the field empty to skip; it never changes the dataset output.

### A note on plans

The `proxy` field governs the product listing/search connection, which works on every Apify plan including the free tier. Product detail and reviews (on by default) always use a residential connection at extra cost, regardless of this setting.

# Actor input Schema

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

'search' finds products by keyword or category name, with real site filters and sort. 'url' scrapes any product, search-result, or category page URL you paste, walking pagination forward automatically.

## `searchTerm` (type: `string`):

Free-text keyword (e.g. 'ecksofa') or a category name (e.g. 'sofas', 'laptop', 'waschmaschine') to browse a whole listing -- both go through OTTO's own search route.

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

Paste one or more OTTO product pages (.../p/<slug>-<id>/), or search/category listing pages (e.g. .../suche/<term>/ or a category page like .../moebel/sofas/ecksofas/). Pagination continues forward automatically.

## `specialsOnly` (type: `boolean`):

Keep only products currently showing a reduced price (strike-through original price + discount %). Narrows the same search/category listing, verified live -- combine with Sort = 'Highest discount' to surface the best offers first. No extra fetch.

## `brands` (type: `array`):

Only return products from these brands, e.g. '99rooms', 'Samsung', 'Jockenhöfer Gruppe'. Match the exact brand name as shown on the site. Leave empty for all brands.

## `minRating` (type: `integer`):

Only return products rated at or above this many stars, 1-5.

## `minPrice` (type: `number`):

Only return products priced at or above this amount, in euros.

## `maxPrice` (type: `number`):

Only return products priced at or below this amount, in euros.

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

OTTO's own real sort order, applied server-side so paginated results stay correctly ordered across pages.

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

Adds the full breadcrumb category path, flattened technical specs, seller/partner identity (OTTO vs marketplace partner), EAN/GTIN/SKU, return policy, and full image gallery from the product detail page. Current price, was-price/discount, variant matrix and rating are already included without this toggle. A pasted product URL always fetches this page regardless of the toggle (it is the only source of that item's data) -- the toggle controls whether these extra fields are kept.

## `fetchReviews` (type: `boolean`):

Fetch each product's native customer reviews: overall rating, review count, and per-review author/location/date/rating/verified-purchase/title/body/helpful-votes. Products with no reviews simply return an empty list. Shares the same product-detail fetch as 'Fetch full product detail' when both are on.

## `maxReviewsPerProduct` (type: `integer`):

Cap on reviews fetched per product when 'Fetch reviews' is on. 0 = all reviews the product detail page renders.

## `maxPages` (type: `integer`):

Stop after this many result-page fetches per search/category/URL entry. 0 (default) = unlimited -- the run walks the full catalogue and stops at Max products total instead.

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

Hard cap on total products returned across every search/category/URL entry. 0 = unlimited (still bounded by Max pages per search).

## `resumeFromRunId` (type: `string`):

Paste a previous run id (or its dataset id) to continue that run: products already collected there are skipped, so this run only returns new products (a delta). Leave empty for a normal run. For recurring daily/weekly monitoring of the same search, use Incremental mode below instead.

## `incrementalMode` (type: `boolean`):

Turn this on for daily or recurring monitoring. The first run returns all matching products as NEW. Later runs normally return only NEW, UPDATED, and REAPPEARED products. Turn on "Emit unchanged" or "Emit expired" only when you also want those products returned (and billed). State is kept separately for each search/URL and detail-mode setup; use State key when you want to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from a previous run above.

## `stateKey` (type: `string`):

Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Leave empty to let the actor derive a key automatically from the search/URL and detail settings -- different searches then never mix state with each other.

## `emitUnchanged` (type: `boolean`):

Off by default. Turn on to also return products that have not changed since the last run, marked UNCHANGED. This returns -- and bills -- extra rows you already have, so leave it off unless you specifically want the full snapshot every run.

## `emitExpired` (type: `boolean`):

Off by default. Turn on to also return products that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned the tracked search -- not when Max products capped it or when Resume was used. This returns -- and bills -- extra synthetic rows, so leave it off unless you need expiry tracking.

## `proxy` (type: `object`):

Governs the product listing/search connection, which works on every Apify plan including the free tier. The product detail and reviews fetch (on by default) always uses a residential connection at extra cost, regardless of this setting.

## `mcpConnectors` (type: `array`):

Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify -> Settings -> Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com).

## `notionParentPageUrl` (type: `string`):

URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors.

## `maxNotifyListings` (type: `integer`):

Cap on items written to each connector per run. Does not affect the dataset.

## Actor input object example

```json
{
  "mode": "search",
  "searchTerm": "ecksofa",
  "urls": [
    "https://www.otto.de/suche/ecksofa/"
  ],
  "specialsOnly": false,
  "brands": [],
  "sortBy": "RELEVANCE",
  "fetchDetails": false,
  "fetchReviews": true,
  "maxReviewsPerProduct": 10,
  "maxPages": 0,
  "maxItems": 20,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "proxy": {
    "useApifyProxy": true
  },
  "maxNotifyListings": 50
}
```

# 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 = {
    "mode": "search",
    "searchTerm": "ecksofa",
    "urls": [
        "https://www.otto.de/suche/ecksofa/"
    ],
    "brands": [],
    "incrementalMode": false,
    "emitUnchanged": false,
    "emitExpired": false,
    "proxy": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/otto-de-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",
    "searchTerm": "ecksofa",
    "urls": ["https://www.otto.de/suche/ecksofa/"],
    "brands": [],
    "incrementalMode": False,
    "emitUnchanged": False,
    "emitExpired": False,
    "proxy": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/otto-de-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",
  "searchTerm": "ecksofa",
  "urls": [
    "https://www.otto.de/suche/ecksofa/"
  ],
  "brands": [],
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "proxy": {
    "useApifyProxy": true
  }
}' |
apify call abotapi/otto-de-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/otto-de-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/SyedlV8S2KZwmns3Y/builds/UtC1WqvAMp8AjTlyI/openapi.json