# idealo API

> The idealo API by everydata.io returns live idealo data (price comparison idealo.de: product search, every shop's offer for a product, price history) as structured JSON: 3 endpoints under /idl, one API key, 100 free requests a month.

- URL: https://everydata.io/apis/idealo
- Updated: 2026-11-09
- Publisher: everydata.io (https://everydata.io)

idealo does not offer a public API for reading its price comparison. The everydata.io idealo API reads the public idealo.de pages when you call it: send a keyword, a product link or a product id and get the lowest price, the number of offers and every listed shop's offer with price, shipping cost, total price and delivery time back as JSON.

Compare what shops charge for the same product on idealo.de, the price comparison site of Germany. Search by keyword and get up to 36 products with lowest price, number of offers, rating, manufacturer, key features, energy label, category and the cheapest shop. Or open one product by link or id and get every listed shop's offer: price, shipping cost, total price, availability, delivery time, condition, shop rating, payment methods and the marketplace seller, plus price range, EAN, datasheet, variants and images. Beta: idealo.de only, and the search returns the first page of results; use the sort orders to reach other parts of a result. Shops appear with their shop name only; no user reviews or reviewer data.

## Key facts

- Status: beta
- Endpoints: 3 (path prefix `/idl`)
- Quota: A call to the idealo API counts as 1 request against the monthly quota.
- Pricing: 100 free requests a month; paid plans from €30 a month for 5,000 requests (€1.00–€6.00 per 1,000 requests). One quota is shared across all 34 platforms; failed requests (5xx, blocked pages) are not counted.
- Measured average response time (last 24 h): 940 ms, success rate 100% – live figures at https://everydata.io/status
- Authentication: `x-api-key` header

## Endpoints

- `GET /idl/idealo-search-by-keyword` – Search products by keyword. Search the idealo.de price comparison by keyword (beta). Params: `keyword`, `page`?, `sortBy`?, `domainCode`?.
- `GET /idl/idealo-lookup-product` – Product details with merchant offers. Product details and merchant offers of an idealo.de product (beta), by URL or `productId`: title, manufacturer, lowest price and price range, total offer count, rating, EAN, energy label, datasheet specs, categories, im… Params: `url`?, `productId`?, `domainCode`?.
- `GET /idl/idealo-price-history` – Price history (observations collected by this API). Prices of a idealo product as observed by this API: every lookup stores one observation, this endpoint returns them for the last `days` days (oldest first) with the lowest and highest price, addressed by URL or `product… Params: `url`?, `productId`?, `domainCode`?, `days`?.

## Example

```bash
curl -s "https://api.everydata.io/idl/idealo-lookup-product?url=https%3A%2F%2Fwww.idealo.de%2Fpreisvergleich%2FOffersOfProduct%2F203247542_-iphone-15-128gb-schwarz-apple.html" \
  -H "x-api-key: YOUR_API_KEY"
```

```json
{
  "responseStatus": "PRODUCT_FOUND_RESPONSE",
  "responseMessage": "Product successfully found!",
  "productTitle": "Apple iPhone 15 128GB Schwarz",
  "manufacturer": "Apple",
  "productId": "203247542",
  "bestPrice": 589.9,
  "priceRange": {
    "min": 589.9,
    "max": 956.31
  },
  "offerCount": 35,
  "currency": "EUR",
  "productRating": "4.9",
  "countReview": 17,
  "ean": "0195949034244",
  "energyEfficiencyClass": "B",
  "offers": [
    {
      "position": 1,
      "merchant": "smartport.de (Marktplatzhändler)",
      "marketplaceSeller": "MOXMA",
      "price": 589.9,
      "shippingCost": 0,
      "totalPrice": 589.9,
      "availability": "available",
      "deliveryTime": "Lieferung: bis Fr. 09.10.",
      "condition": "new",
      "merchantRating": "4.4",
      "merchantRatingCount": 1542,
      "paymentMethods": [
        "PayPal",
        "Rechnung"
      ]
    }
  ]
}
```

## Use cases

- Price comparison across German shops
- Merchant offer monitoring
- MAP / RRP compliance across shops
- AI assistants answering “where is it cheapest?”

## FAQ

### Is there an official idealo API?

We are not aware of a public idealo API for reading offers or search results; idealo's business interfaces are aimed at shops and partners that list their own offers. everydata.io is an independent service, not affiliated with idealo: it loads the public idealo.de pages at request time and returns them as JSON. The price history comes from the prices this API observed in its own lookups, not from idealo's price chart.

### What does “beta” mean for the idealo API?

The endpoints and response fields are usable today, but they can still change and the platform is not yet counted in the headline success rate. Blocked or failed calls are not billed.

### What data does the idealo API return?

Price comparison idealo.de: product search, every shop's offer for a product, price history. The API has 3 endpoints under the /idl path – search products, product offers and price history – and every response is structured JSON that starts with responseStatus and responseMessage.

### How much does the idealo API cost?

A call to the idealo API counts as 1 request against the monthly quota. The idealo API is included in every plan and shares one quota with all other platforms: 100 free requests a month; paid plans from €30 a month for 5,000 requests (€1.00–€6.00 per 1,000 requests). Failed requests (5xx, blocked pages) are not counted.

### Is the idealo data realtime?

Yes. Each request loads the live idealo page when you call the API – there is no database of old snapshots in between.

### Do I need a idealo account or an official idealo API key?

No. You only need an everydata.io API key, sent in the x-api-key header. The free plan works without a credit card.

### Is this a idealo scraper?

It replaces one. everydata.io loads the live idealo pages for you and returns parsed JSON fields, so you do not build or maintain a idealo scraper, parser or proxy setup yourself. Retries are included, and a request that still fails costs no quota.

### What happens when idealo blocks a request?

The API retries the fetch automatically. If the page still cannot be loaded you get a 502 or 503 error, and that request costs no quota. Success rates and response times per platform are measured around the clock on the status page.

### Can ChatGPT, Claude or an AI agent use the idealo API?

Yes. Connect the hosted everydata.io MCP server and the assistant can call every idealo endpoint as a tool, or register the plain HTTPS endpoints as functions in any agent framework. The endpoint list is also in /llms.txt and the OpenAPI spec.

## More

- [All platforms](https://everydata.io/apis) · [Pricing](https://everydata.io/pricing) · [API reference](https://everydata.io/docs) · [Getting started](https://everydata.io/docs/getting-started) · [MCP server](https://everydata.io/docs/mcp) · [Status](https://everydata.io/status)
- Machine-readable: [llms.txt](https://everydata.io/llms.txt), [llms-full.txt](https://everydata.io/llms-full.txt), [OpenAPI](https://api.everydata.io/openapi.json)
