# Idealo Scraper – Price Comparison Data (`unnoted/idealo-price-search`) Actor

Search idealo.de, Germany's price comparison site, by keyword or category URL: product name, best price in euros, number of shop offers, cheapest shop and its shipping, user rating, test grade, category, features and image. Export JSON, CSV or Excel. No login needed. Unofficial.

- **URL**: https://apify.com/unnoted/idealo-price-search.md
- **Developed by:** [Unnoted](https://apify.com/unnoted) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 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.

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

### What does Idealo Scraper – Price Comparison Data do?

Idealo Scraper collects the products idealo.de, Germany's largest price comparison site, shows for your search terms or category URLs: product name, best price in euros, how many shops offer it, the cheapest shop and its shipping cost, user rating, test grade, category, key features and image, as clean rows you can export or call by API.

Unofficial, not affiliated with Idealo.

**Main features:** search by keyword or paste links, up to 100,000 products per run, no login needed, export to JSON, CSV or Excel, and full API and scheduling support on Apify.

### What data can you get from Idealo?

Each product is one row with these fields:

| Field | Description |
|---|---|
| `productId` | idealo product id (always filled) |
| `url` | Link to the product's price comparison page on idealo.de (always filled) |
| `title` | Product name (always filled) |
| `bestPrice` | Lowest price across all shops, in euros |
| `currency` | Always EUR |
| `offerCount` | Number of shop offers compared for the product |
| `bestPriceShop` | Shop with the lowest price (e.g. Amazon, alza.de) |
| `bestPriceShippingEur` | Shipping cost of the lowest-price offer, in euros (0 when free) |
| `usedOnly` | Whether only used or refurbished offers are listed |
| `rating` | Average user rating, 0 to 5 stars (in half stars) |
| `reviewCount` | Number of user reviews |
| `testRating` | Average grade from product tests, German school grades from 1.0 (very good) to 6.0 |
| `productType` | Product type as idealo labels it (e.g. Bluetooth-Kopfhörer, 5G Handy) |
| `characteristics` | Key features as shown in the results (e.g. kabellos, Bluetooth 5.3, 10 h Akkulaufzeit) |
| `category` | idealo category name (e.g. Kopfhörer) |
| `categoryId` | idealo category id |
| `energyEfficiencyClass` | EU energy efficiency class, where the product has one (e.g. A) |
| `bestsellerRank` | Bestseller rank, where idealo marks the product as a bestseller |
| `imageUrl` | Product image |
| `itemType` | product (compared across shops) or offer (a single shop's offer) |
| `position` | Position in the results of the search or URL (1 = first result) |
| `searchQuery` | The search term or URL that found it |
| `scrapedAt` | When the product was collected (ISO 8601) |

### How to scrape Idealo with Idealo Scraper – Price Comparison Data

1. Open Idealo Scraper – Price Comparison Data on Apify and go to the **Input** tab.
2. In **Search terms**, enter `kopfhörer`.
3. In **Max products**, enter `20`.
4. Click **Start** and wait for the run to finish. A small run like this one takes under a minute.
5. Open the **Output** tab to see the results, or download them as JSON, CSV, Excel or HTML.

### Input

See the **Input** tab for every option. The fields:

| Field | Name | What it does | Default |
|---|---|---|---|
| `searchQueries` | Search terms | What to search for on idealo.de, one per line, as you would type it in the search box (e.g. kopfhörer, iphone 16, waschmaschine). Product and brand names work in English too. |  |
| `startUrls` | Category or search URLs | idealo.de result pages to collect, one per line (e.g. https://www.idealo.de/preisvergleich/ProductCategory/2520.html). Open a category, set any filter on the website (brand, features, price band), then paste the URL here. |  |
| `maxItems` | Max products | Maximum number of products in total, across all searches and URLs. You pay only for products saved. | `100` |

Example input:

```json
{
  "searchQueries": [
    "kopfhörer"
  ],
  "maxItems": 20
}
```

### Output

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. One real result:

```json
{
  "productId": "207671730",
  "url": "https://www.idealo.de/preisvergleich/OffersOfProduct/207671730_-airpods-pro-3-apple.html",
  "title": "Apple AirPods Pro 3",
  "bestPrice": 207.9,
  "currency": "EUR",
  "offerCount": 67,
  "bestPriceShop": "smartport.de (Marktplatzhändler)",
  "bestPriceShippingEur": 0,
  "usedOnly": false,
  "rating": 4.5,
  "reviewCount": 10,
  "testRating": 1.4,
  "productType": "Bluetooth-Kopfhörer",
  "characteristics": [
    "Bluetooth-Kopfhörer",
    "im Ohr sitzend",
    "kabellos",
    "Apple Siri",
    "Bluetooth 5.3",
    "10 h Akkulaufzeit",
    "Gesamtlaufzeit (inkl.Ladecase) 24 h",
    "Schnellladefunktion 5 Minuten für 1 Stunde Laufzeit",
    "Gewicht 5,55 g",
    "wasserdicht",
    "aktive Geräuschunterdrückung"
  ],
  "category": "Kopfhörer",
  "categoryId": "2520",
  "energyEfficiencyClass": null,
  "bestsellerRank": 1,
  "imageUrl": "https://cdn.idealo.com/folder/Product/207671/7/207671730/s1_produktbild_mittelgross/apple-airpods-pro-3.jpg",
  "itemType": "product",
  "position": 1,
  "searchQuery": "kopfhörer",
  "scrapedAt": "2026-10-08T20:21:39.668Z"
}
```

### How much does it cost to scrape Idealo?

Idealo Scraper – Price Comparison Data uses pay-per-event pricing: **$5.00 per 1,000 products** (Product). You pay only for products saved to the dataset; platform usage is included in the price. Each run also has Apify's standard start fee of a fraction of a cent.

| Products | Price |
|---|---|
| 100 | $0.50 |
| 1,000 | $5.00 |
| 10,000 | $50.00 |

Set **Max items** (and the run's maximum cost in the run options) to cap what a run can spend. The run stops when either limit is reached.

### Use cases

- **Price monitoring:** track the best price of your products or a whole category in Germany every day.
- **Competitor research:** see which shops win the lowest price and how many shops compete per product.
- **Assortment and market research:** list every product in a category with its type, features, ratings and price band.
- **Repricing and deal alerts:** schedule a run and send price drops to Google Sheets, Slack or email.
- **Product launches:** check how new models are priced and rated against the rest of the category.

### Tips

- Paste a **category URL** for the cleanest results: open a category on idealo.de, set filters (brand, features), and copy the address.
- A search that idealo matches to one category pages through that category, up to about 4,000 products. A broad search (e.g. a brand name) also goes through each category idealo suggests for it.
- Search in German for the best matches (e.g. kopfhörer, waschmaschine); brand and model names work as they are.
- Products found by more than one search are saved once, so overlapping searches don't cost twice.
- Schedule the Actor daily to build a price history for the products you follow.

### FAQ

#### Is it legal to scrape Idealo?

Idealo Scraper – Price Comparison Data collects only data that Idealo shows publicly to every visitor, and it leaves out personal data such as private profiles and contact details. Our Actors are ethical and do not extract private user data. Results could still contain personal data in titles or descriptions written by uploaders. 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 are responsible for how you use the data.

#### Can I use it through an API?

Yes. Every Apify Actor has an API: start runs, pass input and read results over HTTP, or use the JavaScript and Python clients. See the **API** tab on the Actor page for ready-made examples.

#### Can I schedule runs and connect other apps?

Yes. Use Apify **Schedules** to run Idealo Scraper – Price Comparison Data every hour, day or week, and integrations (Make, Zapier, Google Sheets, webhooks and more) to send the results where you need them.

#### Why did I get fewer results than expected?

The run stops at **Max items** or at the run's maximum cost, whichever comes first. Idealo may also return fewer results for rare search terms. Duplicates across search terms are saved once. Check the run's `RUN_SUMMARY` record in the key-value store for the inputs that returned nothing.

#### What if it stops working?

Sites change. We run a daily check of our own and fix breakages quickly. If something looks wrong, open an issue in the **Issues** tab with the run link and we'll look at it.

#### Are the prices in euros?

Yes. bestPrice is the lowest price idealo.de shows across all shops, in euros, and bestPriceShippingEur is that offer's shipping cost.

#### Do I get every shop's offer?

Not in this Actor: it collects what the search and category results show, which is the best price, the cheapest shop and the number of offers. Open the product URL for the full offer list.

#### What does testRating mean?

It is the average grade from product tests, in German school grades: 1.0 is very good and 6.0 is poor. rating is the user rating in stars.

#### Does it work for other idealo countries?

It covers idealo.de (Germany). Prices and texts are those of the German site.

### Not included

No personal data: user reviews, reviewer names and profiles are not collected. Shop names are businesses. Per-shop offer lists and price history charts are not included.

### More Actors from us

- [AliExpress Search Scraper – Products & Prices](https://apify.com/unnoted/aliexpress-product-search)
- [BBB Scraper – Business Ratings & Accreditation](https://apify.com/unnoted/bbb-business-search)
- [Bilibili Scraper – Video Search & Stats API](https://apify.com/unnoted/bilibili-video-scraper)
- [Bumeran Jobs Scraper – LATAM Job Listings](https://apify.com/unnoted/bumeran-job-listings)
- [Foundit Jobs Scraper – India Job Listings API](https://apify.com/unnoted/foundit-job-listings)
- [Google Jobs Scraper – Job Listings API](https://apify.com/unnoted/google-jobs-listings)
- [Google Play Reviews Scraper – App Reviews API](https://apify.com/unnoted/google-play-reviews-scraper)
- [Google Trends Scraper – Interest & Related Queries](https://apify.com/unnoted/google-trends-data)
- [Kleinanzeigen Scraper – Listings & Prices](https://apify.com/unnoted/kleinanzeigen-listings-scraper)
- [Mercari Japan Scraper – Listings & Prices API](https://apify.com/unnoted/mercari-japan-search)
- [Resident Advisor Scraper – RA Event Listings](https://apify.com/unnoted/resident-advisor-events)
- [Sainsbury's Scraper – UK Grocery Prices](https://apify.com/unnoted/sainsburys-grocery-search)
- [Tokopedia Scraper – Product Search & Prices](https://apify.com/unnoted/tokopedia-product-search)
- [Workday Jobs Scraper – Any Careers Site](https://apify.com/unnoted/workday-jobs-scraper)
- [Yandex Maps Scraper – Places & Business Data](https://apify.com/unnoted/yandex-maps-places)

***

**Suchbegriffe (keywords):** idealo Scraper · Preisvergleich Daten exportieren · Bestpreis · günstigster Shop · Versandkosten · Testnote · Kundenbewertung · Preisbeobachtung · JSON CSV Excel

# Actor input Schema

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

What to search for on idealo.de, one per line, as you would type it in the search box (e.g. kopfhörer, iphone 16, waschmaschine). Product and brand names work in English too.

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

idealo.de result pages to collect, one per line (e.g. https://www.idealo.de/preisvergleich/ProductCategory/2520.html). Open a category, set any filter on the website (brand, features, price band), then paste the URL here.

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

Maximum number of products in total, across all searches and URLs. You pay only for products saved.

## Actor input object example

```json
{
  "searchQueries": [
    "kopfhörer"
  ],
  "maxItems": 20
}
```

# Actor output Schema

## `results` (type: `string`):

One item per product.

## `runSummary` (type: `string`):

Items saved, inputs done, and how complete each field was.

# 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 = {
    "searchQueries": [
        "kopfhörer"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("unnoted/idealo-price-search").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 = {
    "searchQueries": ["kopfhörer"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("unnoted/idealo-price-search").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 '{
  "searchQueries": [
    "kopfhörer"
  ],
  "maxItems": 20
}' |
apify call unnoted/idealo-price-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,unnoted/idealo-price-search"
        }
    }
}
```

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/4IcHRWeSig0Rt8XC2/builds/jGZiL7OQmx5NuL31d/openapi.json