# Idealo Scraper & Price Data API (`parsebird/idealo-scraper`) Actor Look up Idealo products by GTIN/EAN, product ID, search term, or URL, and pull full price comparison data: offers, shops, ratings. Includes shop-info lookups. - **URL**: https://apify.com/parsebird/idealo-scraper.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.49 / 1,000 lookups 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 & Price Data API **Idealo Scraper & Price Data API** looks up products on [idealo](https://www.idealo.de/), Germany's largest price comparison site, and returns clean, structured price and offer data — no browser, no manual searching, no scraping code required.
Look up products by GTIN/EAN, Idealo product ID, search term, or product URL across 6 Idealo marketplaces (Germany, Austria, Spain, France, Italy, UK) — get every shop offer, price, shipping cost, and shop rating in one structured JSON record, plus dedicated shop-info lookups for Germany.
##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor: Actor ID `parsebird/idealo-scraper` on Apify. Call it with `ApifyClient` — e.g. `client.actor("parsebird/idealo-scraper").call(run_input={"operation": "search-by-gtin", "values": ["4009803341163", "4014835778306"], "country": "de"})` — where `operation` is one of `search-by-gtin`, `search-by-id`, `search-by-term`, `search-by-url`, `shop-info` (default `search-by-gtin`), `values` is an array of 1–50 strings matching that operation (GTINs/EANs, Idealo product IDs, search terms, product URLs, or shop IDs), and `country` is one of `de`, `at`, `es`, `fr`, `it`, `uk` (default `de`; shop-info always reads Germany). Each dataset item returns `query`, `operation`, `country`, `status` (`found`/`not_found`/`error`), and `result` — for products: `name`, `brand`, `ean`, `price_min`/`price_avg`/`price_max`, `offers_count`, `categories`, `review_rating`, and a full `offers` array with `shop_name`, `shop_url`, `price`, `shipping`, `total`, `availability_text`, and shop ratings; for shop-info: shop profile, address, payment methods, and legal links. Full field reference and the API spec are on the Actor's API tab, and you can get an Apify API token from the Integrations tab of your Apify account. #### What does Idealo Scraper & Price Data API do? [Idealo](https://www.idealo.de/) aggregates hundreds of millions of offers from thousands of online shops across Germany, Austria, Spain, France, Italy, and the UK. This actor turns that catalog into an API: - 🔍 **Five lookup modes** — search by GTIN/EAN barcode, Idealo's internal product ID, a free-text search term, a product URL, or a shop ID for shop-info. - 🌍 **6 marketplaces** — Germany (idealo.de), Austria (idealo.at), Spain (idealo.es), France (idealo.fr), Italy (idealo.it), and the UK (idealo.co.uk). - 💰 **Full offer list per product** — every shop's price, shipping cost, total, availability, condition, and shop rating, not just the lowest price. - 🏪 **Shop-info lookups** — a shop's address, payment methods, legal pages, and review rating straight from idealo.de. - ⚡ **No browser needed** — runs as a lightweight HTTP actor, so batches of 50 lookups finish in minutes. - 📅 **Schedule & monitor** — run this Actor on a recurring [schedule](https://docs.apify.com/platform/schedules) to track price changes over time, or trigger it from your own pipeline via the [Apify API](https://docs.apify.com/api/v2) or [integrations](https://apify.com/integrations) (Zapier, Make, n8n, webhooks). #### What data can you extract from idealo? | Field | Description | |-------|-------------| | `name`, `brand`, `ean` | Product title, brand, and GTIN/EAN when idealo has one on file | | `price_min` / `price_avg` / `price_max` | Lowest, average, and highest current offer price | | `offers_count` | Total number of shop offers idealo lists for the product | | `categories` / `category_ids` | Idealo's category breadcrumb for the product | | `review_rating` / `review_count` | Aggregate product review score | | `offers[].shop_name` / `shop_url` | The selling shop's name and, when idealo exposes it, its own website | | `offers[].price` / `shipping` / `total` | Item price, shipping cost, and total cost for that offer | | `offers[].availability_text` | Delivery estimate as shown on idealo | | `offers[].shop_review_rating` / `shop_review_count` | That shop's idealo rating | | `shop.address`, `shop.payment_methods`, `shop.legal_urls` | Shop-info fields (Germany only) | #### How to use Idealo Scraper & Price Data API 1. Click **Try for free** on the Actor page, or start a run via the API. 2. Pick an **Operation**: `search-by-gtin`, `search-by-id`, `search-by-term`, `search-by-url`, or `shop-info`. 3. Add 1–50 **Values** matching that operation — for example a list of EANs for `search-by-gtin`, or shop IDs for `shop-info`. 4. Pick a **Country** marketplace (default `de`). Shop-info always reads the German marketplace. 5. Click **Start** and open the **Dataset** tab when the run finishes — export results as JSON, CSV, Excel, or XML, or pull them straight from the [Apify API](https://docs.apify.com/api/v2). #### How much does it cost to run Idealo Scraper & Price Data API? This Actor uses [pay-per-event pricing](https://docs.apify.com/platform/actors/publishing/monetize#pay-per-event-pricing-model) — you pay per completed lookup, not for compute time. | Event | Free / default | Bronze | Silver | Gold | |-------|----------------|--------|--------|------| | `lookup-completed` (per 1,000) | $3.99 | $3.49 | $2.99 | $2.49 | Only lookups with `status: found` or `status: not_found` are charged; a lookup that returns `status: error` (idealo blocked the request, or the input was invalid) is free. A batch of 50 GTIN lookups where every one resolves therefore costs a few cents. [Apify plans](https://apify.com/pricing) include monthly platform usage credits that apply toward these events. #### Input | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | operation | string | **Yes** | `search-by-gtin` | `search-by-gtin`, `search-by-id`, `search-by-term`, `search-by-url`, or `shop-info` | | values | array of strings | **Yes** | — | 1–50 lookups matching the operation; blanks and duplicates are dropped | | country | string | No | `de` | `de`, `at`, `es`, `fr`, `it`, or `uk` | #### Output example ```json { "query": "4009803341163", "operation": "search-by-gtin", "country": "de", "status": "found", "result": { "name": "Revell Spray sand, matt (34134)", "brand": "Revell", "ean": "4009803341163", "price_min": 7.49, "price_avg": 9.74, "price_max": 11.99, "offers_count": 7, "offers": [ { "shop_name": "Amazon", "price": 7.49, "shipping": 0.0, "total": 7.49, "availability_text": "Nur noch 1 auf Lager (mehr ist unterwegs)." } ], "source": "idealo", "country": "de", "fetched_at": "2026-09-19T11:33:42.883Z" } } ``` #### Using the API — Python and JavaScript **Python** ([apify-client](https://docs.apify.com/api/client/python/)): ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("parsebird/idealo-scraper").call(run_input={ "operation": "search-by-gtin", "values": ["4009803341163", "4014835778306"], "country": "de", }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["status"], item.get("result", {}).get("name")) ``` **JavaScript** ([apify-client](https://docs.apify.com/api/client/js/)): ```javascript import { ApifyClient } from "apify-client"; const client = new ApifyClient({ token: "" }); const run = await client.actor("parsebird/idealo-scraper").call({ operation: "search-by-term", values: ["iphone 17 pro"], country: "de", }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` #### Is it legal to scrape idealo? Idealo publishes product prices and shop offers publicly for shoppers to compare. This Actor only reads publicly visible pages — it does not access data behind a login. Scraping publicly available data is generally considered legal, but you're responsible for how you use the data and for complying with idealo's [terms of service](https://www.idealo.de/legal/agb.html) and applicable law (e.g. GDPR when handling personal data). See the Apify blog on [web scraping and the law](https://blog.apify.com/is-web-scraping-legal/) for more background. #### Other price-comparison and e-commerce scrapers - [Yandex Market Scraper](https://apify.com/parsebird/yandex-market-scraper) — product and offer data from Yandex Market - [AliExpress Scraper](https://apify.com/parsebird/aliexpress-scraper) — product listings and pricing from AliExpress - [Walmart Product Scraper](https://apify.com/parsebird/walmart-product-scraper) — product data and pricing from Walmart.com - [Trustpilot Reviews Scraper](https://apify.com/parsebird/trustpilot-reviews-scraper) — reviews and ratings from Trustpilot #### FAQ **What's the difference between search-by-gtin and search-by-term?** Both query idealo's search, but a GTIN/EAN barcode is far more likely to land on an exact single product, while a search term may need idealo's own relevance ranking to pick the best match — the Actor always resolves to idealo's canonical product page either way. **Why did my lookup return `not_found`?** Either idealo has no listing for that GTIN/ID/term in the selected country's marketplace, or the product ID/URL doesn't exist. Idealo's catalog size differs by country — Germany and Austria have the deepest coverage. **Can I look up a shop from any country?** No — shop-info always reads idealo.de (Germany), since that is idealo's shop-review system of record. Pass a numeric idealo shop ID (visible in a product's offer list or shop page URL). **Does this use AI to match products?** No. Every field is extracted directly from idealo's own page data (structured product data, offer listings, and shop profiles) — nothing is inferred or generated. **Can I schedule recurring runs to track price changes?** Yes — use Apify's [Scheduler](https://docs.apify.com/platform/schedules) to run this Actor daily or weekly and monitor `price_min` over time. **Found a bug or a country where a lookup doesn't resolve?** Please open an issue on the Actor's Issues tab — idealo's page structure varies slightly by country and we actively maintain this Actor. # Changelog This Actor's version history is a separate document: https://apify.com/parsebird/idealo-scraper/changelog.md # Actor input Schema ## `operation` (type: `string`): Which Idealo lookup to run for every value in the list below. ## `values` (type: `array`): One entry per lookup: GTINs/EANs, Idealo product IDs, search terms, product URLs, or shop IDs — matching the Operation above. Max 50 per run. Blank and duplicate entries are dropped. ## `country` (type: `string`): Idealo marketplace to query. Shop info always reads Germany's marketplace regardless of this setting. ## Actor input object example ```json { "operation": "search-by-gtin", "values": [ "4009803341163", "4014835778306" ], "country": "de" } ``` # Actor output Schema ## `dataset` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "values": [ "4009803341163", "4014835778306" ] }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "values": [ "4009803341163", "4014835778306", ] } # Run the Actor and wait for it to finish run = client.actor("parsebird/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 '{ "values": [ "4009803341163", "4014835778306" ] }' | apify call parsebird/idealo-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/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 ` 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/rj0WoSm66kVfBIDPO/builds/XRlHENemcr0fZZvWM/openapi.json