# Idealo Price Data API (`pricepirate/idealo-price-data-api`) Actor Real-time Idealo price data across 6 European markets. Look up any product by EAN/GTIN, ID, search term, or URL - **URL**: https://apify.com/pricepirate/idealo-price-data-api.md - **Developed by:** [PricePirate](https://apify.com/pricepirate) (community) - **Categories:** E-commerce, Developer tools, Other - **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Idealo Price Comparison Data API Tap into **Idealo**, one of Europe's largest price-comparison portals, through a single clean Actor. Look up a product by **barcode (GTIN/EAN), Idealo product ID, product URL, or search term** to get the full list of merchant offers Idealo shows for it: prices, shipping, totals, delivery/availability, shop ratings and voucher flags — all in one unified JSON structure. You can also pull **shop profiles** (metadata, ratings, payment & shipping info, top products) by Idealo shop ID. Built by [PricePirate](https://pricepirate.com), a [UCX Media](https://gaponik.com) product — full developer documentation lives at [pricepirate.com/docs](https://pricepirate.com/docs/en/solutions/idealo-api). Perfect for price-comparison sites, [repricing](https://pricepirate.com/docs/en/solutions/idealo-repricing) and margin tools, [price monitoring](https://pricepirate.com/docs/en/solutions/price-monitoring) and [dynamic pricing](https://pricepirate.com/docs/en/solutions/dynamic-pricing) engines, deal & coupon apps, browser extensions, dropshipping and product research, and AI shopping assistants targeting European markets. ### ✓ 5 Ways to Look Up Idealo Data Choose whichever identifier you already have: | Operation | Value format | Returns | |---|---|---| | `search-by-gtin` | GTIN / EAN / UPC barcode, 8–14 digits | Product with all merchant offers | | `search-by-id` | Idealo product ID (e.g. `207562448`) | Product with all merchant offers | | `search-by-url` | Idealo product URL | Product with all merchant offers | | `search-by-term` | Free-text search term (e.g. `iphone 16`) | Best-matching product listing (no per-merchant offers) | | `shop-info` | Numeric Idealo shop ID | Shop profile + top products (Germany only) | > **search-by-term** returns the top-matching **listing** — id, name, URL, > images, rating, lowest price, and offer count — with an empty `offers` array. > To pull the full per-merchant offer breakdown, follow up with > **search-by-id** using the returned product `id`. More on the difference > between listings and offers > [in the docs](https://pricepirate.com/docs/en/guide/concepts/listings-and-offers). ### ✓ 6-Country Coverage Query localized pricing across Idealo's European marketplaces: Germany (`de`, default), Austria (`at`), Spain (`es`), France (`fr`), Italy (`it`), United Kingdom (`uk`). `shop-info` currently supports Germany (`de`) only. ### ✓ Complete Multi-Merchant Offer Data For a barcode, ID, or URL lookup you get the full competitive landscape for the matched product: - **Product:** title, listing URL, matched ID, EAN, brand, description, image gallery, categories, review rating and review count - **Price summary:** lowest price, highest price, average price, total offer count - **Per-merchant offers:** shop name, shop URL, shop type (standalone vs. marketplace), marketplace name, price, shipping cost, [total price](https://pricepirate.com/docs/en/guide/concepts/total-price) (price + shipping — the number Idealo actually ranks by), currency, item condition, delivery/availability, voucher and free-return flags, and ranking position - **Store trust signals:** per-shop review rating and review count ### ✓ Bypass Idealo Bot Protection We handle the hard part — rotating infrastructure and anti-bot evasion — so you get clean, structured data without managing proxies, headless browsers, or fighting blocks yourself. No job polling either: start the Actor with your values and read the finished results straight from the dataset. ### 💻 Input ```json { "operation": "search-by-gtin", "values": ["4009803341163", "4014835778306"], "country": "de" } ```` - **`operation`** (required): one of `search-by-gtin`, `search-by-id`, `search-by-term`, `search-by-url`, `shop-info`. All values in a run share the same operation. - **`values`** (required): 1–25 strings, each one lookup — barcodes, product IDs, search terms, product URLs, or shop IDs, matching the selected operation. Duplicates and blank entries are dropped. Run the Actor multiple times for larger lists. - **`country`** (optional, default `de`): 2-letter marketplace code — `de`, `at`, `es`, `fr`, `it`, `uk`. URLs passed to `search-by-url` must belong to the same country. ### 💻 Output One dataset item per input value: ```json { "query": "4009803341163", "operation": "search-by-gtin", "country": "de", "status": "found", "result": { "id": "207562448", "name": "Example Product Name", "url": "https://www.idealo.de/preisvergleich/OffersOfProduct/207562448", "ean": "4009803341163", "brand": "Example Brand", "description": "Short spec summary from the listing", "image_urls": ["https://cdn.idealo.com/…/product.jpg"], "review_rating": 4, "review_count": 312, "categories": null, "category_ids": null, "price_min": 129.0, "price_avg": 142.5, "price_max": 159.0, "offers_count": 8, "offers": [ { "sellerId": "Example Store", "shop_name": "Example Store", "shop_url": "http://www.example-store.de", "shop_type": "standalone-shop", "marketplace_name": null, "shop_review_rating": 5, "shop_review_count": 1240, "position": "0", "condition": "new", "currency": "EUR", "price": 129.0, "shipping": 4.99, "total": 133.99, "voucher": false, "free_return": null, "availability_code": "short", "availability_text": "Lieferung in 1-2 Werktagen" } ], "source": "idealo", "country": "de", "fetched_at": "2026-07-17T12:00:03.000Z" } } ``` For **`shop-info`**, `result` contains the shop profile instead: ```json { "query": "123456", "operation": "shop-info", "country": "de", "status": "found", "result": { "shop": { "id": "123456", "name": "Example Store", "url": "http://www.example-store.de", "logo_url": "https://cdn.idealo.com/…/logo.png", "description": "…", "address": { "street": "…", "zip": "…", "city": "…", "country": "DE" }, "review_rating": 4.6, "review_count": 1240, "payment_methods": ["PayPal", "Kreditkarte"], "shipping_methods": ["DHL"], "shipping_costs": { "inland": "4,99 €", "foreign": null, "free_from": "50,00 €", "min_order_value": null }, "legal_urls": { "terms": "…", "imprint": "…" }, "top_categories": ["Haushalt"] }, "top_products": [ { "id": "207562448", "title": "Example Product", "category": "Haushalt", "url": "https://www.idealo.de/…", "image": "https://cdn.idealo.com/…", "price": 129.0, "delivery_price": null, "currency": "EUR", "offers_count": 8, "review_rating": 4, "review_count": 312, "test_note": null, "available": true } ], "source": "idealo", "country": "de", "fetched_at": "2026-07-17T12:00:03.000Z" } } ``` ### 💻 Statuses & Errors `status` is `found`, `not_found`, or `error`. Error items have `result: null` and carry a stable `errorCode`: - `blocked` — Idealo could not be fetched for this value right now - `timeout` — the lookup did not finish within the per-query deadline - `invalid_input` — the value does not match the selected operation - `internal_error` — an unexpected upstream failure - `charge_limit_reached` — skipped because the run's maximum charge was hit Error items are **never charged**. ### 💰 Pricing Pay per event: you are charged once per query that completes (`found` or `not_found`). Failed queries — errors and timeouts — are always free. A run succeeds if at least one query completes and fails only when nothing came back (in which case nothing was charged). ### ⏱ Timing All values in a run are looked up in parallel, and each result is written to the dataset the moment its lookup finishes. Lookups typically complete in well under a minute; each query is given at most ~7 minutes before it is reported as a `timeout` error (uncharged). ### 📚 Documentation & Guides Full documentation is hosted at **pricepirate.com/docs**: - [Idealo API — price & offer data without building a scraper](https://pricepirate.com/docs/en/solutions/idealo-api) - [Listings vs. offers — how Idealo data is structured](https://pricepirate.com/docs/en/guide/concepts/listings-and-offers) - [Total price — why price + shipping decides the ranking](https://pricepirate.com/docs/en/guide/concepts/total-price) - [Idealo repricing — automate your Idealo prices](https://pricepirate.com/docs/en/solutions/idealo-repricing) ### 📬 Contact & Support Questions, higher limits, or a custom integration? Reach out via the Apify issues tab for this Actor and we'll be happy to help. Need a deeper build — custom pricing automation, data pipelines, or a tailored e-commerce integration? That's what we do at [UCX Media](https://gaponik.com), the software studio behind PricePirate. # Actor input Schema ## `operation` (type: `string`): Which Idealo lookup to run for every value. ## `values` (type: `array`): One entry per lookup: GTINs/EANs, Idealo product IDs, search terms, product URLs, or shop IDs — matching the selected operation. Maximum 25 per run. ## `country` (type: `string`): Idealo marketplace to query. Shop info supports Germany only. ## Actor input object example ```json { "operation": "search-by-gtin", "values": [ "4009803341163" ], "country": "de" } ``` # Actor output Schema ## `results` (type: `string`): All lookup results in the default dataset — one item per input value. # 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" ] }; // Run the Actor and wait for it to finish const run = await client.actor("pricepirate/idealo-price-data-api").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"] } # Run the Actor and wait for it to finish run = client.actor("pricepirate/idealo-price-data-api").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 '{ "values": [ "4009803341163" ] }' | apify call pricepirate/idealo-price-data-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=pricepirate/idealo-price-data-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Idealo Price Data API", "description": "Real-time Idealo price data across 6 European markets. Look up any product by EAN/GTIN, ID, search term, or URL", "version": "0.0", "x-build-id": "ghkWyHUXNoJtMvcim" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pricepirate~idealo-price-data-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pricepirate-idealo-price-data-api", "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/pricepirate~idealo-price-data-api/runs": { "post": { "operationId": "runs-sync-pricepirate-idealo-price-data-api", "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/pricepirate~idealo-price-data-api/run-sync": { "post": { "operationId": "run-sync-pricepirate-idealo-price-data-api", "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", "required": [ "operation", "values" ], "properties": { "operation": { "title": "Operation", "enum": [ "search-by-gtin", "search-by-id", "search-by-term", "search-by-url", "shop-info" ], "type": "string", "description": "Which Idealo lookup to run for every value.", "default": "search-by-gtin" }, "values": { "title": "Values", "minItems": 1, "maxItems": 25, "uniqueItems": true, "type": "array", "description": "One entry per lookup: GTINs/EANs, Idealo product IDs, search terms, product URLs, or shop IDs — matching the selected operation. Maximum 25 per run.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "de", "at", "es", "fr", "it", "uk" ], "type": "string", "description": "Idealo marketplace to query. Shop info supports Germany only.", "default": "de" } } }, "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 } } } } } } } } } } ```