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, a UCX Media product — full developer documentation lives at pricepirate.com/docs.

Perfect for price-comparison sites, repricing and margin tools, price monitoring and 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.

✓ 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 (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

{
  "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:

{
  "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:

{
  "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
• Listings vs. offers — how Idealo data is structured
• Total price — why price + shipping decides the ranking
• Idealo repricing — automate your Idealo prices

📬 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, the software studio behind PricePirate.