Idealo

Idealo price-comparison data, with the richest seller-offer detail of any source. Search by keyword, GTIN, pharmacy number (PZN), or look up an Idealo product by ID.

Supported countries

country accepts: de at uk (gb) fr it es

uk and gb are two codes for the same UK marketplace — not a separate locale.

Keys

Key	Values	Description
`term`	Free text	Keyword search.
`id`	Idealo product ID (numeric)	Direct product lookup.
`gtin`	EAN / GTIN-13	GTIN search.
`pzn`	Pharmacy product number	German pharmacy lookup (de).

Topics

Topic	Description
`search` (default)	Product page with the full offer list.

Product `content` fields

Product results (id / gtin / pzn) are sourced from Idealo's offer-list endpoint and focus on offers. Page-only metadata — available_since, last_updated, review_rating, review_count, energy_efficiency — is not included in product results (it remains available on keyword search results, where present).

Field	Description
`id`	Idealo product ID.
`name`	Product title.
`url`	Product URL.
`categories`	Category name(s). Populated for German-market results (`de` / `at`); empty for other locales.
`category_ids`	Primary category id(s) for the product.
`price_min` / `price_avg` / `price_max`	Offer price aggregates.
`offers_count`	Number of offers gathered.
`offers`	Seller offers — see below.
`energy_efficiency`	EU energy efficiency class, where present: one of `A+++`, `A++`, `A+`, `A`, `B`, `C`, `D`, `E`, `F`, `G`, or `null` when not applicable/available. Keyword `search` results only — see note above.

`offers[]` fields

Idealo offers carry detailed seller and listing metadata, which may include:

Field	Description
`shop_name`	Seller / shop name.
`marketplace_name`	Marketplace, when the offer is via a marketplace seller.
`shop_type`	Seller type (e.g. marketplace shop).
`shop_url`	Seller URL.
`shop_review_rating` / `shop_review_count`	Seller review signal.
`position`	Offer position in the list.
`condition`	Item condition.
`voucher`	Voucher/discount info, when present.
`availability_code` / `availability_text`	Availability.
`direct_sale`	Whether the offer is a direct sale.
`free_return`	Whether free returns are offered.
`energy_efficiency`	EU energy efficiency class for this offer, where present: one of `A+++`, `A++`, `A+`, `A`, `B`, `C`, `D`, `E`, `F`, `G`, or `null` when not applicable/available.

Some seller names require an extra resolution step. With seller-name resolution enabled on your account, kwery fills these in for you — see Sources › Seller-name resolution.

Example request

curl -s https://api.kwery.co/job \
  -H "Authorization: Bearer $KWERY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source":"idealo","country":"de","key":"gtin","values":["4006381333962"]}'

Example response

Results are fetched with GET /job/{id}/download once the job is finished — each entry is the result for one input value (abridged):

[
  {
    "key": "4006381333962",
    "success": true,
    "reason": null,
    "content": {
      "id": "1234567890",
      "name": "STABILO point 88 fineliner",
      "url": "https://www.idealo.de/preisvergleich/OffersOfProduct/1234567890.html",
      "categories": ["Schreibwaren"],
      "category_ids": ["12345"],
      "price_min": 12.49,
      "price_avg": 13.99,
      "price_max": 15.49,
      "offers_count": 2,
      "offers": [
        { "shop_name": "office-supplies-de", "shop_type": "marketplace shop", "position": 1, "condition": "new", "availability_code": "available", "availability_text": "in stock", "direct_sale": true, "free_return": true },
        { "shop_name": "papershop24", "shop_type": "standalone shop", "position": 2, "condition": "new" }
      ]
    }
  }
]