> ## Documentation Index
> Fetch the complete documentation index at: https://pricepirate.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Idealo API for Price and Offer Data

> Fetch Idealo price data via API: offers, prices, shipping costs, and total prices by EAN/GTIN, product ID, search term, or URL — no scraper infrastructure required.

The PricePirate Idealo API returns the offer data of an Idealo listing as structured JSON: every seller with price, shipping cost, total price, and position. Query by EAN/GTIN, Idealo product ID, search term, or product URL — without running your own scraper or proxy infrastructure.

<Card title="Idealo API on RapidAPI" icon="api" href="https://rapidapi.com/organization/pricepirate" cta="Open on RapidAPI" arrow="true">
  Subscribe to the Global product on RapidAPI and start with your RapidAPI key.
</Card>

## What data does the API return?

For every queried product you get the listing with all visible offers in one unified JSON shape:

* **Offers per seller** — shop name, shop URL, and position within the listing
* **Prices** — item price, shipping cost, and total price per offer
* **Price ranges** — the listing's cheapest, average, and highest price
* **Extras** — availability, item condition, voucher flags, and store ratings where Idealo exposes them
* **Countries** — Idealo Germany (`de`) and Austria (`at`)

## How to use the API

The API works with asynchronous jobs: you create a lookup job and fetch the result as soon as it is ready — typically within a few seconds.

```bash theme={null}
curl --request POST \
  --url https://<rapidapi-host>.p.rapidapi.com/idealo/search-by-gtin \
  --header 'Content-Type: application/json' \
  --header 'x-rapidapi-host: <rapidapi-host>' \
  --header 'x-rapidapi-key: <rapidapi-key>' \
  --data '{"country":"de","values":["4013474101469"]}'
```

The response contains a `job_id`. Use it to poll for the result:

```bash theme={null}
curl --request GET \
  --url https://<rapidapi-host>.p.rapidapi.com/jobs/<job_id> \
  --header 'x-rapidapi-host: <rapidapi-host>' \
  --header 'x-rapidapi-key: <rapidapi-key>'
```

Once the job is `completed`, the response contains the listing with all offers — each with `shop_name`, `position`, `price`, `shipping`, and `total`.

Beyond barcode lookups, the Idealo API offers three more entry points:

| Endpoint                 | Input              | Typical use                             |
| ------------------------ | ------------------ | --------------------------------------- |
| `/idealo/search-by-gtin` | EAN / GTIN / UPC   | Look up your own products unambiguously |
| `/idealo/search-by-id`   | Idealo product ID  | Re-query known listings on a schedule   |
| `/idealo/search-by-term` | Search term        | Discover listings for a product first   |
| `/idealo/search-by-url`  | Idealo product URL | Resolve listings from existing links    |

Term search returns multiple matching listings with their minimum price and offer count; fetch the full offer breakdown afterwards via `search-by-id`.

## Scraping Idealo vs. using the API

Building your own Idealo scraper looks cheaper — until it runs. In practice, scraping means operating proxies, handling blocks, chasing HTML changes, and continuously validating data quality. Every layout change on Idealo's side can break your pipeline.

The API flips that equation: you send an EAN and get validated, structured JSON back. Maintenance, infrastructure, and format changes are our problem, not yours. Billing is per request through RapidAPI — scale up and down without fixed infrastructure costs.

## How this differs from Idealo's official partner API

Idealo offers its own merchant interfaces (PWS) — for uploading offers and handling Direktkauf orders. Those interfaces manage **your own offers**.

The PricePirate Idealo API answers a different question: **what is every merchant offering on a listing?** It provides the competitive view — the data foundation for price analysis, market monitoring, and your own repricing logic.

## FAQ

<AccordionGroup>
  <Accordion title="Do I need an Idealo account?">
    No. You only need a RapidAPI account and a subscription to the PricePirate API product.
  </Accordion>

  <Accordion title="Which barcodes are supported?">
    Barcodes follow the GTIN standard (8–14 digits) and are compatible with EAN, UPC, and JAN.
  </Accordion>

  <Accordion title="How fresh is the data?">
    Every lookup job queries the listing live. Results are typically available within a few seconds.
  </Accordion>

  <Accordion title="Are there sources beyond Idealo?">
    Yes. The Global product bundles Idealo, Klarna, PriceRunner, Google Shopping, and Allegro in one unified response format. See the [Price Data API](/docs/en/solutions/price-data-api) overview.
  </Accordion>

  <Accordion title="What does the API cost?">
    Billing is per request through RapidAPI. You can find the current plans on the [RapidAPI listing](https://rapidapi.com/organization/pricepirate).
  </Accordion>
</AccordionGroup>

<Card title="Subscribe to the Idealo API" icon="rocket" href="https://rapidapi.com/organization/pricepirate" cta="Start on RapidAPI" arrow="true">
  Choose the Global product and send your first request within minutes.
</Card>

## Related

* [Price Data API: all sources at a glance](/docs/en/solutions/price-data-api)
* [API reference with all endpoints](/docs/en/api/price-data/overview)
* Want prices adjusted automatically instead of just read? See [Idealo repricing](/docs/en/solutions/idealo-repricing).