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

Authorization

ApiKeyAuth
x-api-key<token>

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

In: header

Query Parameters

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

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/idealo/search?query=string"

{  "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  }}

{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}