Get a full Idealo product page from Spain (idealo.es), France (idealo.fr), or Germany (idealo.de). Pass a product URL or a numeric product id (with country when the id is used). WebUnlocker. 3 credits per call. Missing products return 404.
The payload includes title, brand, description, SKU, country, images, price min/max, rating (0-5), the visible shop offers (price, shipping fee, shop, clickout URL), and datasheet specs.
GET https://api.piloterr.com/v2/idealo/product?query=https://www.idealo.es/precios/205227870/asics-novablast-5-1011b974.html
GET https://api.piloterr.com/v2/idealo/product?query=https://www.idealo.fr/prix/201455182/somfy-tahoma-switch-sc-1870595.html
GET https://api.piloterr.com/v2/idealo/product?query=https://www.idealo.de/preisvergleich/OffersOfProduct/202763575_-gel-nyc-1201a789-asics.html
GET https://api.piloterr.com/v2/idealo/product?query=205227870&country=es
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Full Idealo product URL, or a numeric product id |
country |
string |
no |
es (default for numeric ids), fr, or de. Ignored when query is already a URL |
country |
Host |
Product path |
es |
https://www.idealo.es |
/precios/{id} |
fr |
https://www.idealo.fr |
/prix/{id} |
de |
https://www.idealo.de |
/preisvergleich/OffersOfProduct/{id} |
| Field |
Type |
Description |
id / url / title |
string |
Idealo id, canonical product URL, title |
brand / sku / description |
string |
Brand, SKU, short copy |
country |
string |
es, fr, or de |
images |
array |
Gallery URLs |
price.min / price.max |
number |
Lowest and highest listed prices |
price.currency |
string |
EUR |
price.offer_count |
integer |
Marketplace total (can be larger than offers.length) |
rating / review_count |
number / integer |
0-5 score and review count (null if none) |
offers[] |
array |
Visible shop rows (first page, typically up to 20) |
offers[].shop / shop_id |
string |
Shop name and Idealo shop id |
offers[].price / currency |
number / string |
Offer price |
offers[].shipping |
number |
Delivery fee (0 if included, null if unknown) |
offers[].url |
string |
Idealo clickout (/relocator/relocate) |
specs |
object |
Datasheet labels and values (locale of the page) |
- WebUnlocker. 3 credits per call.
- Parameter name is
query (not url).
- Numeric
query plus empty country builds an idealo.es URL.
- Other Idealo TLDs and search URLs return
400.
shipping is the fee (29.45 € envío incl. minus 25.50 becomes 3.95), not the total.price.offer_count is the full shop count. offers is the first visible page.- Spec keys stay in the page language (
Serie, Type de produit, Obermaterial).
- Delisted pages return
404.
| Code |
Meaning |
400 |
Empty query, non-numeric id without URL, or a non es/fr/de product URL |
404 |
Product not found |
500 |
Unlock or parse failed |
- Pull all visible shop offers for a SKU on es / fr / de
- Track min/max price and shipping on a product page
- Enrich catalogs with brand, specs, and images
- Open the cheapest clickout from
offers[0].url
