List the shop offers of one product, best offer first. Each offer has the price, the shipping text, the total price when idealo states it, delivery window and carriers, return policy, payment methods, voucher, shop identity and the shop rating with its rating count. Marketplace sellers are marked. A page holds 20 offers (pages after the first take one extra call to detect the end of the list) and has_more is true for a full page, so the last page of a product with an exact multiple of 20 offers can still say true. Set all=true to get every offer with an exact total: the request walks all pages, takes one call per 20 offers and fails without charge if the product has more than 800 offers. include_shop_ratings adds idealo's own shop rating to each offer with about one extra second per shop; it works with page only. When shipping_known is false the shipping cost is not stated by idealo; it is not free.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
3 optional filters available.
string
Required
idealo product ID from search, for example 200474612.
200474612
integer
Optional
1-based page of 20 offers. Defaults to 1. Not allowed with all.
1
boolean
Optional
Set true to return every offer of the product.
true
boolean
Optional
Set true to add idealo's shop rating (idealo_rating) to every offer. Not allowed with all.
true
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
meta
offers
success
has_more
product_id
total_offers
Common offers fields
shop
price
title
voucher
{
"meta": {
"duration_ms": 1500,
"upstream_calls": 2
},
"offers": [
{
"shop": {
"id": "277785",
"name": "best-in-saeco.de",
"rating": 5,
"rating_count": 6,
"is_marketplace": false
},
"price": 409,
"title": "PHILIPS Series 5400 Kaffeevollautomat EP5447/90",
"voucher": null,
"currency": "EUR",
"delivery": {
"status": "Lieferung: bis Do. 22.10.",
"window": "bis Do. 22.10.",
"providers": [
"DHL",
"DPD"
]
},
"offer_key": "f4592a4a035f79570daeb30f5a95af0f",
"total_price": 409,
"return_policy": "R\u00fccksendung 30 Tage kostenfrei",
"shipping_text": "409,00 \u20ac inkl. Versand",
"shipping_costs": 0,
"shipping_known": true,
"payment_methods": [
"Rechnung",
"Vorkasse"
],
"price_formatted": "409,00 \u20ac",
"is_best_total_price": true
}
],
"success": true,
"has_more": false,
"product_id": "200474612",
"total_offers": 24
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
Returned when a required parameter is missing or a value is out of range. No credits are charged.
Not Found
Returned when idealo does not know the product, shop or page. No credits are charged.
Service Unavailable
Returned when idealo could not be read after several attempts. Failed requests are not charged. Try again.
Unexpected Response
Returned when idealo answers with a page this API cannot read. Failed requests are not charged.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.