Piloterr

Idealo Product

GET
/v2/idealo/product

Get an Idealo product from Spain, France, or Germany. URL or product id. Offers, shipping, specs, and images via WebUnlocker (3 credits).

Credit cost: 3 credits per call

Authentification

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Paramètres de requête

query*string

Full Idealo product URL, or a numeric product id.

Example 1 (Spain):

https://www.idealo.es/precios/205227870/asics-novablast-5-1011b974.html

Example 2 (France):

https://www.idealo.fr/prix/201455182/somfy-tahoma-switch-sc-1870595.html

Example 3 (Germany):

https://www.idealo.de/preisvergleich/OffersOfProduct/202763575_-gel-nyc-1201a789-asics.html

Example 4 (id + country):

205227870

Notes:

  • URLs must be /precios/, /prix/, or /OffersOfProduct/ on idealo.es / .fr / .de.
  • A numeric id uses country (es default).
country?string

Region when query is a numeric product id.

  • es: /precios/{id} (default)
  • fr: /prix/{id}
  • de: /preisvergleich/OffersOfProduct/{id}

Ignored when query is already a URL. Other values return 400.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Corps de la réponse

Successful response

application/json
  1. response
id?string
sku?string
url?string
brand?string
price?
specs?
title?string
images?array<string>
offers?array<>
rating?number
country?string
description?string
review_count?integer
Example Request
curl -X GET 'https://api.piloterr.com/v2/idealo/product?query=string'
Example Response
{  "id": "205227870",  "sku": "205227870",  "url": "https://www.idealo.es/precios/205227870/asics-novablast-5-1011b974.html",  "brand": "Asics",  "price": {    "max": 225.01,    "min": 105,    "currency": "EUR",    "offer_count": 163  },  "specs": {    "Drop": "8 mm",    "Para": "hombre",    "Serie": "Asics Novablast",    "Cierre": "cordones",    "Para uso": "entrenamiento, carrera",    "Atención": "Las ofertas pueden incluir productos de diferentes tallas",    "Superficie": "todoterreno",    "Entresuelas": "BOUNCE, espuma",    "Propiedades": "amortiguación, ligeras, transpirable",    "Equipamiento": "reflectantes, talón reforzado",    "Material exterior": "textil",    "Material interior": "malla",    "Tipos de producto": "Zapatillas con amortiguación, Zapatillas running ligeras",    "Técnica de carrera": "apoyo con el retropié",    "Materiales de la suela": "espuma, AHAR",    "Sistemas de amortiguación": "FF Blast Plus, FF Blast, FF BLAST PLUS ECO",    "Características de la suela": "amortiguación",    "Características de la plantilla": "transpirable"  },  "title": "Asics Novablast 5 (1011B974)",  "images": [    "https://cdn.idealo.com/folder/Product/205274/0/205274075/s11_produktbild_max/asics-novablast-5-1011b974-500-greyish-purple-coral-reef.jpg",    "https://cdn.idealo.com/folder/Product/208662/4/208662404/s11_produktbild_max/asics-novablast-5-1011b974-black-cobalt-burst.jpg",    "https://cdn.idealo.com/folder/Product/206583/8/206583866/s11_produktbild_max/asics-novablast-5-men-midnight-orange-glow.jpg",    "https://cdn.idealo.com/folder/Product/205359/1/205359157/s11_produktbild_max/asics-novablast-5-1011b974-002-black-carrier-grey.jpg"  ],  "offers": [    {      "url": "https://www.idealo.es/relocator/relocate?categoryId=22875&offerKey=6a184d7d786523382f943b3456543900&pos=1&price=105.00&productid=205227870&sid=285299&type=offer",      "shop": "amazon.es",      "price": 105,      "shop_id": "285299",      "currency": "EUR",      "shipping": 0    },    {      "url": "https://www.idealo.es/relocator/relocate?categoryId=22875&offerKey=002a5a5f7de0d6b2a3911ce153a7ca0e&pos=2&price=105.00&productid=205227870&sid=307375&type=offer",      "shop": "runnerinn.com (ES)",      "price": 105,      "shop_id": "307375",      "currency": "EUR",      "shipping": 1.99    },    {      "url": "https://www.idealo.es/relocator/relocate?categoryId=22875&offerKey=02c7a21a790598e4b569c08a502a679a&pos=3&price=105.00&productid=205227870&sid=307375&type=offer",      "shop": "runnerinn.com (ES)",      "price": 105,      "shop_id": "307375",      "currency": "EUR",      "shipping": 1.99    }  ],  "rating": 4.9,  "country": "es",  "description": "Zapatillas running Asics  Novablast 5 (1011B974) al mejor precio en idealo.es ! | ✓ Guía para comprar online ✓ Análisis y opiniones ✓ Las mejores ofertas y precios baratos",  "review_count": 10}

Idealista Search GET

Précédent

Idealo Search GET

Suivant