Piloterr

Idealo Search

GET
/v2/idealo/search

Search Idealo Spain, France, and Germany. Keyword or search URL. Prices, shipping, ratings, and pagination via WebUnlocker (3 credits).

Credit cost: 3 credits per call

Autorización

ApiKeyAuth
headerx-api-key<token>

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

Parámetros de consulta

query*string

Keyword or full Idealo search URL for Spain, France, or Germany.

Example 1 (Spain keyword):

maison

Example 2 (France URL):

https://www.idealo.fr/prechcat.html?q=asics

Example 3 (Germany URL):

https://www.idealo.de/preisvergleich/MainSearchProductCategory.html?q=asics

Notes:

  • Keywords need country (es default, fr, de).
  • A full search URL is used as-is. Add page or ?page=2 to paginate.
  • France uses /prechcat.html, not /resultats.html.
country?string

Region when query is a keyword.

  • es: idealo.es (default)
  • fr: idealo.fr
  • de: idealo.de

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

page?number

Search page. 2 appends ?page=2.

Example:

2
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

Cuerpo de la respuesta

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/idealo/search?query=string'
Example Response
{  "results": [    {      "id": "200139376",      "url": "https://www.idealo.es/precios/200139376/maison-margiela-replica-jazz-club-eau-de-toilette.html",      "image": "https://cdn.idealo.com/folder/Product/200139/3/200139376/s11_produktbild_mittelgross/maison-margiela-replica-jazz-club-eau-de-toilette.jpg",      "price": 25.5,      "title": "Maison Margiela Replica Jazz Club Eau de Toilette",      "rating": 4.5,      "currency": "EUR",      "shipping": 3.95,      "shop_name": "notino.es",      "category_id": "16252",      "offer_count": 26,      "review_count": 158,      "characteristics": [        "Eau de Toilette unisex",        "cuero",        "2013"      ]    },    {      "id": "201140705",      "url": "https://www.idealo.es/precios/201140705/maison-margiela-replica-by-the-fireplace-eau-de-toilette.html",      "image": "https://cdn.idealo.com/folder/Product/201140/7/201140705/s11_produktbild_mittelgross/maison-margiela-replica-by-the-fireplace-eau-de-toilette.jpg",      "price": 22.79,      "title": "Maison Margiela Replica By the Fireplace Eau de Toilette",      "rating": 4.5,      "currency": "EUR",      "shipping": 4.95,      "shop_name": "deloox.es",      "category_id": "16252",      "offer_count": 20,      "review_count": 11,      "characteristics": [        "Eau de Toilette unisex",        "amaderado",        "2015",        "Perfumista Marie Salamagne"      ]    }  ],  "pagination": {    "next": "https://www.idealo.es/resultados.html?q=maison&page=2",    "page": 1,    "per_page": 60,    "total_pages": 23,    "total_results": 1370  }}

Idealo Product GET

Anterior

IKEA Product GET

Siguiente