# idealo Scraper – Prices, Shop Offers & EAN Lookup, 6 Countries (`apimy/idealo-scraper`) Actor

idealo scraper: search by product name, EAN barcode or link in 6 countries (DE, AT, FR, IT, ES, UK) and get every shop's offer: item price, shipping, total incl. shipping, delivery time and shop rating. Up to 20 offers per product included. Typical run: a 10-product search in about 5 seconds.

- **URL**: https://apify.com/apimy/idealo-scraper.md
- **Developed by:** [Nikita Iakovlev](https://apify.com/apimy) (community)
- **Categories:** E-commerce, Developer tools
- **Features:** Limited permissions
- **Stats:** 18 total users, 7 monthly users, 99.9% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $2.80 / 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/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

## idealo Scraper – Prices, Shop Offers & EAN Lookup in 6 Countries

**Get every shop price for a product on idealo — with shipping, total price, delivery time, payment methods and shop rating — from idealo.de, idealo.at, idealo.fr, idealo.it, idealo.es and idealo.co.uk.** Look products up by **EAN / GTIN barcode**, idealo product ID, link, free-text search, category page or shop ID. Add **specifications, variants, pros & cons**, and put it on a schedule to get **only the prices that changed** since the last run.

No login, no cookies, no API key. You pay per product delivered; barcodes idealo does not know are **free**.

***

### What you get

| You give | You get |
|---|---|
| EAN / GTIN / UPC barcode | The idealo product page it belongs to: details + all shop offers. Unknown barcode → a free `not_found` row with up to 3 closest products. |
| idealo product ID (`203248697`) | Same product row, on the country you choose. |
| idealo link (product, search, category, shop) | Product row, search rows, or shop row — the country comes from the link. |
| Search words (`dyson v15`) | One light row per result (title, lowest price, offer count, rating, best shop) — or, with **Open every search result**, a full product row with offers for each. |
| Shop ID (`334615`) | Shop address, country, rating, number of ratings, latest reviews. |

**Every product row** contains:

- `productId`, `productGroupId` (the “family”, e.g. all iPhone 15 colours), `title`, `variantTitle`, `brand`, `gtin`, `sku`
- `category`, `categoryPath` (full breadcrumb), `categoryId`
- `rating` (1–5) and `reviewCount` from idealo users
- `lowestPrice`, `highestPrice`, `averageOfferPrice`, `lowestTotalPrice` (incl. shipping), `currency`, `offerCount`
- `cheapestShop` — who has the lowest total price, with the click-out link
- `images` (all gallery images), `energyClass`, `description`
- `pros` and `cons` (idealo editorial)
- `variants` — every colour / size / storage version with its own ID, GTIN and link
- `specifications` — the full idealo data sheet as `{ section, name, value }` (typically 30–90 lines)
- `faq` — the questions and answers idealo shows on the page
- `userReviews` — latest user reviews (optional)
- `pricesUpdatedAt` — when idealo last imported shop prices
- `offers` — **all shop offers** (see below)
- price-watch fields: `priceChangeType`, `previousLowestPrice`, `priceChange`, `priceChangePct`, `previousOfferCount`, `changedOffers`, `previousCheckedAt`

**Every shop offer** contains:

`position`, `offerTitle` (the shop's own title), `price`, `shippingCost`, `totalPrice`, `freeShipping`, `currency`, `pricePerUnit` (e.g. `17,99 €/kg` where the shop shows it), `deliveryTime`, `deliveryText`, `carriers` (DHL, GLS…), `returnPolicy`, `paymentMethods` (PayPal, Klarna, invoice, prepayment…), `shopName`, `shopLocation` (city), `shopId`, `shopRating`, `shopReviewCount`, `isMarketplace`, `marketplaceSeller`, `shopLogo`, `badges`, `voucherPrice`, `usedOrRefurbished`, `offerKey`, `offerVariantId`, `offerVariantName`, `clickoutUrl` and — with the shop-country filter — `shopCountry`.

***

### Why this one

| | **This Actor** | pricepirate (idealo Price Data API) |
|---|---|---|
| Price per product | **$0.0039** → $0.0028 on Gold+ | $0.005 → $0.0039 on Gold+ |
| Shop offers per product | first 20 included, more for $0.00005 each | per result |
| Not-found barcode | **free** | not stated |
| Brand, rating, review count for barcode lookups | **yes** | empty in our test (`brand`, `review_rating`, `review_count` = null) |
| Search result rows without opening the product | **$0.001** | $0.005 |
| Specifications / data sheet | **yes, full** | no |
| Variants (colours / sizes) with GTINs | **yes** | no |
| Pros & cons, FAQ, user reviews | **yes** | no |
| Filters: shop rating, shop ratings count, free shipping, no marketplaces, no used, **shop country** | **yes** | no |
| Price-change monitoring (“only what changed”) | **yes, built in** | no |
| One row per offer for Excel | **yes** | no |
| Category / search links, paging | **yes** | one operation per run |
| Countries | 6 | 6 |

Run comparison on the same input is at the end of this page (“Tested side by side”).

***

### How to use

1. Put barcodes into **EAN / GTIN barcodes**, or a search into **Search words**, or paste idealo links.
2. Pick the **Country** (Germany by default). Links always use their own country.
3. Press **Start**. A typical product with 20 offers takes about one second.
4. Download as JSON, CSV, Excel, or read it through the API.

Leave everything empty and press Start to see a demo: one iPhone barcode and the search “airpods pro 2” on idealo.de.

#### Input examples

**Barcode lookup (the most common case):**

```json
{
  "eans": ["0195949034572", "4251168330577", "4006160012613"],
  "country": "de"
}
```

**Full product data for the first 10 results of a search, offers as rows for a spreadsheet:**

```json
{
  "searchQueries": ["kaffeevollautomat"],
  "maxProductsPerSearch": 10,
  "openSearchResults": true,
  "offersOutput": "rows"
}
```

**Category listing, light rows, price range:**

```json
{
  "urls": ["https://www.idealo.de/preisvergleich/ProductCategory/19116.html"],
  "maxProductsPerSearch": 200,
  "maxSearchPages": 6,
  "minPrice": 300,
  "maxPrice": 900
}
```

**Only good German shops with free shipping, up to 100 offers:**

```json
{
  "productIds": ["203235721"],
  "maxOffersPerProduct": 100,
  "minShopRating": "4.5",
  "minShopReviews": 100,
  "onlyFreeShipping": true,
  "excludeMarketplaces": true,
  "shopCountries": ["DE"]
}
```

**Daily price watch (schedule it):**

```json
{
  "eans": ["0195949034572", "4251168330577"],
  "country": "de",
  "priceWatchStore": "my-idealo-watch",
  "onlyPriceChanges": true
}
```

The first run delivers every product with `priceChangeType: "new"`. From the second run on, products with the same lowest price, offer count and shop prices are **skipped and not charged**; the rest come with `up`, `down` or `offers-changed`, the previous price and the change in money and percent.

**Shop information:**

```json
{ "shopIds": ["334615"], "country": "de" }
```

#### Output example (product, shortened)

```json
{
  "type": "product",
  "status": "found",
  "inputType": "ean",
  "input": "0195949034572",
  "country": "de",
  "productId": "203248697",
  "productGroupId": "203235721",
  "title": "Apple iPhone 15 128GB Blau",
  "variantTitle": "128GB Blau",
  "brand": "Apple",
  "gtin": "0195949034572",
  "category": "Apple iPhone 15",
  "categoryPath": ["Elektroartikel", "Telekommunikation", "Handys & Smartphones", "Apple iPhone 15"],
  "categoryId": "19116",
  "rating": 4.54,
  "reviewCount": 914,
  "lowestPrice": 654.2,
  "highestPrice": 899,
  "averageOfferPrice": 757.66,
  "lowestTotalPrice": 654.2,
  "currency": "EUR",
  "offerCount": 14,
  "offersReturned": 14,
  "cheapestShop": { "shopName": "eBay", "shopId": "9701", "totalPrice": 654.2, "clickoutUrl": "https://www.idealo.de/relocator/relocate?..." },
  "energyClass": "B",
  "pros": ["sehr helles Display", "leistungsstarker Prozessor", "hochauflösende Hauptkamera", "universeller USB-C-Anschluss"],
  "cons": ["kein Teleobjektiv", "Display mit geringer 60-fps-Wiederholrate"],
  "variantCount": 14,
  "variants": [{ "id": "203247542", "name": "iphone 15 128gb schwarz apple", "url": "https://www.idealo.de/preisvergleich/OffersOfProduct/203247542_-iphone-15-128gb-schwarz-apple.html" }],
  "specifications": [
    { "section": "Allgemeines", "name": "Markteinführung", "value": "2023" },
    { "section": "Display", "name": "Displaygröße", "value": "6,1 Zoll / 15,494 cm" }
  ],
  "pricesUpdatedAt": "Daten vom 11.11.2026 06:49",
  "offers": [
    {
      "position": 3,
      "offerTitle": "Apple iPhone 15 128GB Schwarz Neuware / OVP inkl. 19% MwSt.",
      "price": 671,
      "shippingCost": 6,
      "totalPrice": 677,
      "freeShipping": false,
      "currency": "EUR",
      "deliveryTime": "bis Mo. 16.11.",
      "carriers": ["DHL", "Deutsche Post"],
      "paymentMethods": ["PayPal", "Visa", "Mastercard", "American Express", "Vorkasse", "Amazon Pay"],
      "shopName": "zodis.de",
      "shopLocation": "Köln",
      "shopId": "334615",
      "shopRating": 4.6,
      "shopReviewCount": 224,
      "isMarketplace": false,
      "clickoutUrl": "https://www.idealo.de/relocator/relocate?categoryId=19116&offerKey=07873c18f37526a0bc3161ae319a1751&pos=3&price=671.00&productid=203235721&sid=334615&type=offer"
    }
  ],
  "url": "https://www.idealo.de/preisvergleich/OffersOfProduct/203248697_-iphone-15-128gb-blau-apple.html",
  "scrapedAt": "2026-11-11T07:04:52.120Z"
}
```

#### Output example (search result row)

```json
{
  "type": "search-result",
  "inputType": "search",
  "input": "airpods pro 2",
  "country": "de",
  "rank": 1,
  "resultType": "product",
  "id": "202092559",
  "title": "Apple AirPods Pro 2",
  "lowestPrice": 175.99,
  "currency": "EUR",
  "offerCount": 44,
  "rating": 4,
  "reviewCount": 1889,
  "bestShop": { "shopId": "336073", "shopName": "bosaverna.de", "shippingCost": 0 },
  "url": "https://www.idealo.de/preisvergleich/OffersOfProduct/202092559_-airpods-pro-2-apple.html",
  "totalResults": 117
}
```

#### Output example (not found — free)

```json
{
  "type": "error",
  "kind": "no-results",
  "status": "not_found",
  "inputType": "ean",
  "input": "4002515289693",
  "country": "de",
  "error": "EAN 4002515289693 is not on idealo.de (idealo answers with its general search page). Not charged.",
  "possibleMatches": []
}
```

***

### Dataset views

The Output tab has four ready views:

- **Products** — one line per product: title, GTIN, brand, lowest / lowest-total / average price, offers, rating, category.
- **Shop offers** — every offer as a line (works for both output modes: nested offers are unwound).
- **Price changes** — price-watch results: change type, previous and current lowest price, change in money and percent.
- **Search results** — light search and category rows.

Filter out the free rows with `type != "notice"` and `type != "error"`.

***

### Typical uses

- **Repricing and price monitoring for online shops.** Put your catalogue's EANs into a scheduled run with a price watch name; you get only the products where the market moved, with the cheapest shop and its total price.
- **MAP / UVP compliance for brands.** Check which shops sell below the recommended price, including marketplace sellers (`isMarketplace`, `marketplaceSeller`).
- **Market research in a category.** Read a category page with light rows ($1 per 1,000 products), then open only the interesting products.
- **Shop due diligence.** Shop rating, number of ratings, address and country for every shop that sells a product — or by shop ID.
- **Cross-country arbitrage.** Run the same EANs on de, at, fr, it, es and uk and compare `lowestTotalPrice`.
- **Product data enrichment.** Barcode → brand, category path, full spec sheet, images, variants with their own GTINs.
- **AI agents and RAG.** Every row is flat JSON with stable IDs; the data sheet comes as `{section, name, value}` triples that LLMs read well.

***

### Pricing

Pay per event. You pay only for what you get:

| Event | Free / Bronze | Silver | Gold, Platinum, Diamond |
|---|---|---|---|
| **Product** (details + up to 20 shop offers included) | $0.0039 | $0.0034 | $0.0028 |
| **Extra shop offer** (each above 20) | $0.00005 | $0.00005 | $0.00005 |
| **Search result** (light row, product not opened) | $0.001 | $0.0009 | $0.0008 |
| **Shop** | $0.002 | $0.0018 | $0.0015 |
| **Actor start** (once per run, per GB of memory) | $0.001 | $0.001 | $0.001 |

**Always free:** barcodes idealo does not know (`not_found`), errors, malformed input, unchanged products in price-watch mode, products skipped by “only new”, the summary row.

#### What it costs in practice

- **100 barcodes**, 20 offers each, Free plan: 100 × $0.0039 + $0.001 = **$0.391**. On Gold: **$0.281**. pricepirate: $0.50 / $0.39.
- **1,000 barcodes, daily price watch**, 15% change per day, Gold: first day $2.80, then about 150 × $0.0028 = **$0.42 a day**.
- **One product with all 95 offers**: $0.0039 + 75 × $0.00005 = **$0.0077**.
- **A category of 1,000 products, light rows**: 1,000 × $0.001 = **$1.00** (Gold $0.80).
- **10 shops by ID**: $0.02.

Set **Max cost per run** in the run options and the Actor stops cleanly at that amount — everything written is paid for, nothing more is taken.

***

### Input reference

| Field | What it does |
|---|---|
| `eans` | Barcodes (8–14 digits). |
| `productIds` | idealo product IDs. |
| `urls` | idealo links: product, search, category, shop. Country taken from the link. |
| `searchQueries` | Free-text searches. |
| `shopIds` | idealo shop IDs. |
| `country` | `de`, `at`, `fr`, `it`, `es`, `uk` — for barcodes, IDs, searches and shop IDs. |
| `maxProductsPerSearch` | Results per search / category link (default 20). |
| `maxSearchPages` | Result pages per search, 36 per page (default 3). |
| `openSearchResults` | Turn search results into full product rows with offers. |
| `minPrice`, `maxPrice` | Price range for search results. |
| `includeOffers` | Shop offers on/off. |
| `maxOffersPerProduct` | 0–500 (default 20; 20 are included in the product price). |
| `offersOutput` | `nested` (offers array in the product row) or `rows` (one row per offer). |
| `minShopRating` | Any, 3.0+, 3.5+, 4.0+, 4.5+. |
| `minShopReviews` | Minimum number of shop ratings. |
| `onlyFreeShipping` | Keep only offers without shipping cost. |
| `excludeMarketplaces` | Drop marketplace sellers. |
| `excludeUsed` | Drop used / refurbished offers. |
| `shopCountries` | Keep only shops registered in these countries (`DE`, `AT`, `NL`…). |
| `priceWatchStore` | Name of your price watch — enables change fields. |
| `onlyPriceChanges` | Skip unchanged products (default on with a watch name). |
| `onlyNewRowsStore` | Skip products already delivered under this name. |
| `includeSpecifications` | Full data sheet. |
| `includeVariants` | Other versions of the product. |
| `includeUserReviews` | Latest user reviews. |
| `maxConcurrency` | Products read in parallel (1–8). |
| `includeRunSummary` | One free summary row with the cost of the run. |

***

### Integrations

**API (curl):**

```bash
curl -X POST "https://api.apify.com/v2/acts/apimy~idealo-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"eans":["0195949034572"],"country":"de"}'
```

**Python:**

```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_TOKEN")
run = client.actor("apimy/idealo-scraper").call(run_input={"eans": ["0195949034572"], "country": "de"})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    if item["type"] == "product":
        print(item["title"], item["lowestTotalPrice"], item["cheapestShop"]["shopName"])
```

**JavaScript:**

```js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('apimy/idealo-scraper').call({ searchQueries: ['dyson v15'], openSearchResults: true, maxProductsPerSearch: 5 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

**MCP (Claude, Cursor and other AI agents):** add the Apify MCP server (`https://mcp.apify.com`) and allow the tool `apimy/idealo-scraper`; the agent can then ask “find the cheapest German shop for EAN 0195949034572”.

**Make, n8n, Zapier:** use the Apify app / node → “Run Actor” with `apimy/idealo-scraper`, then “Get dataset items”. For alerts: schedule with a `priceWatchStore`, and in the next step keep rows with `priceChangeType = "down"`.

**Google Sheets:** choose “One row per offer” and use the Apify Google Sheets integration — every offer lands in its own line.

***

### FAQ

**Do I need an idealo account or an API key?** No. The Actor reads the public idealo pages, the same ones any visitor sees.

**Which countries?** Germany (idealo.de), Austria (idealo.at), France (idealo.fr), Italy (idealo.it), Spain (idealo.es) and the United Kingdom (idealo.co.uk). Prices are in EUR, on idealo.co.uk in GBP.

**What happens with a barcode idealo does not know?** You get a free row with `status: "not_found"` and, where idealo suggests something, up to three `possibleMatches`. Nothing is charged.

**Why do two barcodes give the same product group?** idealo groups variants (colours, storage sizes). Each barcode leads to its own variant (`productId`), and `productGroupId` tells you the family.

**Is `offerCount` the same as the number of offers I get?** `offerCount` is what idealo lists; `offersReturned` is what you received after your limit and filters. Raise **Max offers per product** to get all of them.

**Is shipping included in `totalPrice`?** Yes — `totalPrice` = `price` + `shippingCost` as idealo shows it for delivery inside the selected country.

**How fresh are the prices?** As fresh as idealo: `pricesUpdatedAt` shows idealo's last import (usually within the hour). The Actor reads the page live at run time.

**Can I get only products whose price changed?** Yes — give **Price watch name** and schedule the Actor. Unchanged products are skipped and free.

**How do I get one row per offer?** Set **Offers output** to “One row per offer”. Same price as nested.

**Can I filter by shop country?** Yes — `shopCountries`. The Actor reads each shop's address once per run, so it is a bit slower.

**Does it work for categories?** Yes — paste a category or search result link; paging is automatic (36 results per page).

**Can I scrape a whole category with offers?** Yes: category link + `openSearchResults: true` + a high `maxProductsPerSearch`. Every product is charged as a product.

**What about blocks?** The Actor starts with a plain request and escalates to residential proxies and an unblocker only when a page is refused; you never pay more because of it.

**Does it give the idealo price history chart?** No — see Limitations.

**Can I run many barcodes at once?** Yes, thousands. They are read in parallel (`maxConcurrency`, default 4).

**Can I cap what a run costs?** Yes, set “Max cost per run” in the run options; the Actor stops cleanly before the cap.

**Is the data legal to use?** The Actor collects publicly available price information. You are responsible for how you use it; do not collect personal data from user reviews beyond what you need.

***

### Limitations (honest)

- **No price history chart.** idealo serves the 3M/6M/1Y chart only to a real browser session; the Actor does not get it. Use the price watch mode on a schedule to build your own history — every run stores the lowest price and each shop's total.
- **No “free shipping from X €” threshold.** idealo shows it only inside the shop's own page, not in the offer list.
- **`pricePerUnit` only where the shop states it** (food, drugstore, consumables).
- **Shop location is a city** in the offer list; the country (`shopCountry`) needs the shop-country filter or a shop row.
- **Shop rows without a rating** where idealo publishes no shop-level rating (marketplaces such as eBay on idealo.co.uk); offer rows still carry the seller's `shopRating`.
- **`possibleMatches` for unknown barcodes** are idealo's general search results, not a guaranteed match.
- **Variant names** other than the current one are taken from the variant link when idealo does not print them.
- **Apify Free plan:** up to 20 rows per run (5 barcodes / IDs / links, 2 searches with 10 results, 20 offers per product). Any paid Apify plan removes these limits.
- **Text is in the site language** (German on .de/.at, French on .fr…): spec names, delivery texts and payment method names are exactly as idealo shows them.

***

### Tested side by side

Same input for everybody on 11.11.2026: three barcodes (`0195949034572`, `4251168330577`, `4006160012613`) and the search “airpods pro 2”, idealo.de.

![idealo scrapers tested on the same input: this Actor found 3 of 3 barcodes and 5 of 5 search products with 89 shop offers in 7.5 s; pricepirate 3 of 3 barcodes, search without offers, 94 s; memo23 has no barcode input, 196 s; ahmed_jasarevic matched 1 of 3 barcodes](https://api.apify.com/v2/key-value-stores/MzrDrc7jryleDDU75/records/idealo-tested-2026-11-11.png?signature=K7BuiRAfKhaW3OA1JsYO)

| Actor | Barcodes found | Search: products with offers | Shop offers | Run time |
|---|---|---|---|---|
| **This Actor** | **3 of 3** | **5 of 5** | **89** | **7.5 s** |
| pricepirate/idealo-price-data-api | 3 of 3 | 1, without offers | 44 | 68 s + 26 s (two runs: one operation per run) |
| memo23/idealo-scraper | no barcode input (barcode as search: 0) | 3 of 5 | 26 | 196 s |
| ahmed_jasarevic/idealo-scraper | 1 of 3 (other rows were look-alike products) | not reached (shared 5-row limit) | 75 | 23 s |

None of the four returned an idealo price-history chart (ahmed_jasarevic advertises it; its run charged 0 price-history events and the rows had no history).

***

### Support

Something missing or wrong? Open an issue on the Actor page — we answer within a day and usually ship the fix the same week.

# Actor input Schema

## `eans` (type: `array`):

8–14 digit barcodes (EAN-13, GTIN-14, UPC). Each one is matched to its idealo product page with all shop offers. A barcode idealo does not know comes back as a free "not_found" row.

## `productIds` (type: `array`):

The number from an idealo product link, e.g. 203248697 from idealo.de/preisvergleich/OffersOfProduct/203248697\_-iphone-15-128gb-blau-apple.html.

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

Product pages, search or category result pages and shop pages from idealo.de, .at, .fr, .it, .es or .co.uk. The country is taken from the link itself.

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

Free-text searches, exactly like the idealo search box (e.g. "airpods pro 2", "dyson v15"). Each result becomes a row; turn on "Open every search result" to get full product data and shop offers for each.

## `shopIds` (type: `array`):

idealo shop IDs (the "shopId" field of any offer row, or the number in an idealo shop link). Returns the shop's address, country, rating, number of ratings and latest reviews.

## `country` (type: `string`):

Which idealo site barcodes, product IDs, search words and shop IDs are looked up on. Links always use their own country.

## `maxProductsPerSearch` (type: `integer`):

How many results to take from each search word or search/category link (idealo shows 36 per page).

## `maxSearchPages` (type: `integer`):

Upper bound on result pages read per search (36 results each).

## `openSearchResults` (type: `boolean`):

Off: one light row per result (title, lowest price, offer count, rating, best shop) at the search-result price. On: every product result is opened and delivered as a full product row with shop offers, at the product price.

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

Search results only: skip results whose lowest price is below this (in the site currency).

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

Search results only: skip results whose lowest price is above this.

## `includeOffers` (type: `boolean`):

Every shop offer with price, shipping cost, total price, delivery time, carriers, payment methods, shop rating and a click-out link.

## `maxOffersPerProduct` (type: `integer`):

The first 20 offers are included in the product price. Each offer above 20 is charged as "extra offer" (see Pricing).

## `offersOutput` (type: `string`):

Nested keeps one row per product. Rows writes the product row plus one row per shop offer with the product ID, title and GTIN repeated — same price either way.

## `minShopRating` (type: `string`):

Keep only offers from shops rated at least this on idealo (1–5).

## `minShopReviews` (type: `integer`):

Keep only offers from shops with at least this many idealo ratings.

## `onlyFreeShipping` (type: `boolean`):

Drop offers where the total price is higher than the item price.

## `excludeMarketplaces` (type: `boolean`):

Drop offers sold through marketplaces (eBay, Kaufland, Amazon Marketplace and the like).

## `excludeUsed` (type: `boolean`):

Drop offers whose title says used or refurbished.

## `shopCountries` (type: `array`):

Keep only offers from shops registered in these countries (2-letter codes: DE, AT, FR, IT, ES, GB, NL…). Reads each shop's address once per run — a little slower.

## `priceWatchStore` (type: `string`):

Any name, e.g. "my-idealo-watch". The Actor remembers the last lowest price, offer count and each shop's total price under this name and adds previousLowestPrice, priceChange, priceChangePct and priceChangeType to every product row.

## `onlyPriceChanges` (type: `boolean`):

With a price watch name: skip (and do not charge) products whose lowest price, offer count and shop prices are all the same as last time. New products always come through.

## `onlyNewRowsStore` (type: `string`):

Any name, e.g. "new-idealo-products". Products already delivered under this name in earlier runs are skipped and not charged. Good for "new listings in a category".

## `includeSpecifications` (type: `boolean`):

The full idealo data sheet (section, name, value), e.g. display size, energy class, release year.

## `includeVariants` (type: `boolean`):

Other colours / sizes / storage versions of the same product (ProductGroup) with their idealo IDs, GTINs and links.

## `includeUserReviews` (type: `boolean`):

The latest user reviews idealo shows on the product page (author, date, stars, text).

## `maxConcurrency` (type: `integer`):

How many products are read at the same time.

## `includeRunSummary` (type: `boolean`):

One free row at the end: rows delivered, events charged and their cost on your plan.

## Actor input object example

```json
{
  "eans": [
    "0195949034572",
    "4002515289693"
  ],
  "urls": [
    "https://www.idealo.de/preisvergleich/OffersOfProduct/203248697_-iphone-15-128gb-blau-apple.html"
  ],
  "searchQueries": [
    "airpods pro 2"
  ],
  "country": "de",
  "maxProductsPerSearch": 20,
  "maxSearchPages": 3,
  "openSearchResults": false,
  "includeOffers": true,
  "maxOffersPerProduct": 20,
  "offersOutput": "nested",
  "minShopRating": "0",
  "minShopReviews": 0,
  "onlyFreeShipping": false,
  "excludeMarketplaces": false,
  "excludeUsed": false,
  "onlyPriceChanges": true,
  "includeSpecifications": true,
  "includeVariants": true,
  "includeUserReviews": false,
  "maxConcurrency": 4,
  "includeRunSummary": true
}
```

# Actor output Schema

## `products` (type: `string`):

No description

## `offers` (type: `string`):

No description

## `priceChanges` (type: `string`):

No description

## `search` (type: `string`):

No description

## `all` (type: `string`):

No description

## `summary` (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 = {
    "eans": [
        "0195949034572",
        "4002515289693"
    ],
    "urls": [
        "https://www.idealo.de/preisvergleich/OffersOfProduct/203248697_-iphone-15-128gb-blau-apple.html"
    ],
    "searchQueries": [
        "airpods pro 2"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("apimy/idealo-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 = {
    "eans": [
        "0195949034572",
        "4002515289693",
    ],
    "urls": ["https://www.idealo.de/preisvergleich/OffersOfProduct/203248697_-iphone-15-128gb-blau-apple.html"],
    "searchQueries": ["airpods pro 2"],
}

# Run the Actor and wait for it to finish
run = client.actor("apimy/idealo-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 '{
  "eans": [
    "0195949034572",
    "4002515289693"
  ],
  "urls": [
    "https://www.idealo.de/preisvergleich/OffersOfProduct/203248697_-iphone-15-128gb-blau-apple.html"
  ],
  "searchQueries": [
    "airpods pro 2"
  ]
}' |
apify call apimy/idealo-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,apimy/idealo-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/7gVJmLj7pGFX4nIaT/builds/oKm4WyAIJtl9PKcDr/openapi.json
