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
Autorização
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Parâmetros de consulta
query*string
Keyword or full Idealo search URL for Spain, France, or Germany.
Example 1 (Spain keyword):
maisonExample 2 (France URL):
https://www.idealo.fr/prechcat.html?q=asicsExample 3 (Germany URL):
https://www.idealo.de/preisvergleich/MainSearchProductCategory.html?q=asicsNotes:
- Keywords need
country(esdefault,fr,de). - A full search URL is used as-is. Add
pageor?page=2to paginate. - France uses
/prechcat.html, not/resultats.html.
country?string
Region when query is a keyword.
es: idealo.es (default)fr: idealo.frde: idealo.de
Ignored when query is already a URL. Other values return 400.
page?number
Search page. 2 appends ?page=2.
Example:
2Corpo da resposta
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"}