Idealo data
От
3B Data / @CRAWLER2API |
Обновлено 17 дней назад |
eCommerce
Популярность
8.9 / 10
Задержка
81ms
Уровень обслуживания
100%
Health Check
N/A
Назад ко всем руководствам (2)
How to use Idealo data API
1. Introduction
Our Idealo data API is a RESTful service based on JSON format (or others) that provides you with market price and product data on your portfolio items. In order to receive data on one or more offers for products your system asks the API with a specific identifier (GTIN, id, term, URL) and country code (de, us, etc.). Our service visits the website of the data source specified in the request, searches for the product offers and extracts the relevant information. Once this process is done, your system can download the data and use it for further processing.
2. Workflow
The following steps apply when data is requested from Idealo data API:
1.|Create a job
2.|Poll the job (every few minutes) untill results are prepared
2.1. Create a job
2.1.1 Endpoints
There are several endpoints to create a job, based on the search parameter.
- If you want to search for product names, e.g. “iphone 13”, use “Start search by term” endpoint.
- If you want to search for Idealo product ids, e.g. 6719824, use “Start search by id” endpoint.
- If you want to search for product GTINs (Global Trade Item Number), e.g. 190199380554, use “Start search by gtin” endpoint.
GTIN is compatible with EAN (European Article Number), JAN (Japan Article Number) and UPC (Universal Product Code).
2.1.2 Input parameters
A job summarizes your request to collect data for one or more product offers. Each job carries a job_id and can be specified by the following parameters:
- country - alpha-2 country code of the source to request from (de, at,us, etc.)
- values – search value
Available idealo countries:
- de, uk, at, it, fr, es
2.1.3 Response
All start search endpoints returns the job structure including the job_id. This is used in the polling step.
If there is an error in the input parameters e.g. incorrect source, or country an error message is returned.
- Success Response:
Code: 200
Content:
{
"error": false,
"job_id": "5fa2660127a87648da89d17f"
}
- Error Response:
Code: 200
Content:
OR{ "error": true, "message": "missing parameter" } - Code: 401 UNAUTHORIZED
OR - Code: 400 BAD REQUEST
OR - Code: 429 TOO MANY REQUESTS
OR - Code: 500 INTERNAL ERROR
List of possible errors:
- missing parameter - not all required parameters are present
- unknown source - source not supported
- unknown country - country not supported for given source
- not subscribed to source - client not subscribed to source / country
- too many values - more than 1 values submitted
2.2 Poll job results
2.2.1 Endpoints
No matter what start search endpoint was used there is only one endpoint “Poll results”.
2.2.2 Input parameters
A job_id received from start search is used as an input to this endpoint.
2.2.3 Response
Response is a JSON object.
If the job is not finished yet, the “status” field of response is “working”. So poll the endpoint again after a few minutes.
If the job is finished, “status” field is “finished” and “results” field is an arrays of results for each value submitted. The “content” of each results includes the data about the product (title, description, rating, price summary, etc.) and offers of various sellers if available. The content varies somewhat based on the input source.
- Success Response: (job not finished yet)
Code: 200
Content:
{
"error": false,
"job"_id": "620e50be1e672e32b4b36e1a",
"status": "working",
"done": 0,
"all": 2
}
- Success Response: (job finished)
Code: 200
Content:
{
"job_id": "620e50be1e672e32b4b36e1a",
"status": "finished",
"results": [
{
"updated_at": "2022-02-17T13:44:28.528Z",
"query": {
"max_age": 1200,
"max_pages": 1,
"value": "0194252014233",
"key": "gtin",
"country": "de",
"topic": "search",
"source": "idealo"
},
"content": {
"offers": [
{
"direct_sale": false,
"availability_text": "Lieferung innerhalb von 2 - 4 Werktagen nach Zahlungseingang.",
"availability_code": "orange",
"voucher": true,
"free_return": "0",
"total": 550.96,
"shipping": 0,
"price": 550.96,
"currency": "EUR",
"position": "1",
"shop_review_count": 7317,
"shop_review_rating": 100,
"marketplace_name": "eBay",
"shop_type": "marketplace-shop",
"shop_url": "http://www.ebay.de/usr/sr_versandhaus",
"shop_name": "sr_versandhaus"
},
{
"direct_sale": true,
"availability_text": "Pünktliche Lieferung:\n \n \n 1-3 Werktage",
"availability_code": "green",
"voucher": false,
"free_return": "0",
"total": 598,
"shipping": 0,
"price": 598,
"currency": "EUR",
"position": "2",
"shop_review_count": 552,
"shop_review_rating": 80,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.carbonphone",
"shop_name": "CarbonPhone"
},
{
"direct_sale": true,
"availability_text": "Lieferung in 1-5 Tagen (Hinweis für Geschäftskunden: Differenzbesteuerung nach § 25a UStG)",
"availability_code": "orange",
"voucher": false,
"free_return": "30",
"total": 599,
"shipping": 0,
"price": 599,
"currency": "EUR",
"position": "3",
"shop_review_count": 1,
"shop_review_rating": 100,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.sparsmart24.de",
"shop_name": "sparsmart24.de"
},
{
"direct_sale": false,
"availability_text": "Lieferung in 1-5 Tagen (Hinweis für Geschäftskunden: Differenzbesteuerung nach § 25a UStG)",
"availability_code": "orange",
"voucher": false,
"free_return": "30",
"total": 599,
"shipping": 0,
"price": 599,
"currency": "EUR",
"position": "4",
"shop_review_count": 1,
"shop_review_rating": 100,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.sparsmart24.de",
"shop_name": "sparsmart24.de"
},
{
"direct_sale": true,
"availability_text": "1-3 Werktage",
"availability_code": "green",
"voucher": false,
"free_return": "30",
"total": 599,
"shipping": 0,
"price": 599,
"currency": "EUR",
"position": "5",
"shop_review_count": 210,
"shop_review_rating": 80,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.cleverbuy.de",
"shop_name": "cleverbuy.de"
},
{
"direct_sale": false,
"availability_text": "1-3 Werktage",
"availability_code": "green",
"voucher": true,
"free_return": "30",
"total": 599,
"shipping": 0,
"price": 599,
"currency": "EUR",
"position": "6",
"shop_review_count": 210,
"shop_review_rating": 80,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.cleverbuy.de",
"shop_name": "cleverbuy.de"
},
{
"direct_sale": false,
"availability_text": "1-3 Werktage",
"availability_code": "green",
"voucher": false,
"free_return": "14",
"total": 616,
"shipping": 0,
"price": 616,
"currency": "EUR",
"position": "7",
"shop_review_count": 41487,
"shop_review_rating": 80,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.kaufland.de",
"shop_name": "kaufland.de"
},
{
"direct_sale": true,
"availability_text": "Pünktliche Lieferung:\n \n \n \n Sa. 19.02.–Mo. 21.02.",
"availability_code": "green",
"voucher": false,
"free_return": "0",
"total": 617.02,
"shipping": 0,
"price": 617.02,
"currency": "EUR",
"position": "8",
"shop_review_count": 260,
"shop_review_rating": 40,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.buyzoxs.de",
"shop_name": "buyzoxs.de"
},
{
"direct_sale": false,
"availability_text": "Lieferung:\n \n \n Sa. 19.02.–Mo. 21.02.",
"availability_code": "green",
"voucher": false,
"free_return": "0",
"total": 617.02,
"shipping": 0,
"price": 617.02,
"currency": "EUR",
"position": "9",
"shop_review_count": 260,
"shop_review_rating": 40,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.buyzoxs.de",
"shop_name": "buyzoxs.de"
},
{
"direct_sale": true,
"availability_text": "Lieferung:\n \n \n Di. 22.02.–Mi. 23.02.",
"availability_code": "green",
"voucher": false,
"free_return": "0",
"total": 619,
"shipping": 0,
"price": 619,
"currency": "EUR",
"position": "10",
"shop_review_count": 385,
"shop_review_rating": 60,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.autoundsound",
"shop_name": "autoundsound"
},
{
"direct_sale": false,
"availability_text": "3 Tage",
"availability_code": "green",
"voucher": false,
"free_return": "90",
"total": 619,
"shipping": 0,
"price": 619,
"currency": "EUR",
"position": "11",
"shop_review_count": 5691,
"shop_review_rating": 90,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.lidl.de",
"shop_name": "lidl.de"
},
{
"direct_sale": false,
"availability_text": "1 Werktage",
"availability_code": "green",
"voucher": false,
"free_return": "31",
"total": 622,
"shipping": 0,
"price": 622,
"currency": "EUR",
"position": "12",
"shop_review_count": 307,
"shop_review_rating": 90,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.gomibo.de",
"shop_name": "gomibo.de"
},
{
"direct_sale": false,
"availability_text": "Auf Lager, Lieferung innerhalb von 2 Tagen. Berlin jetzt noch schneller.",
"availability_code": "green",
"voucher": false,
"free_return": "30",
"total": 623.9,
"shipping": 0,
"price": 623.9,
"currency": "EUR",
"position": "13",
"shop_review_count": 1390,
"shop_review_rating": 70,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.alza.de",
"shop_name": "alza.de"
},
{
"direct_sale": false,
"availability_text": "Auf Lager.. Express-Versand mit Amazon Prime möglich.",
"availability_code": "green",
"voucher": false,
"free_return": "30",
"total": 625.94,
"shipping": 0,
"price": 625.94,
"currency": "EUR",
"position": "14",
"shop_review_count": 1405,
"shop_review_rating": 40,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.amazon.de",
"shop_name": "Amazon"
},
{
"direct_sale": false,
"availability_text": "lieferbar in ca. 6-8 Wochen",
"availability_code": "orange",
"voucher": false,
"free_return": "14",
"total": 629,
"shipping": 0,
"price": 629,
"currency": "EUR",
"position": "15",
"shop_review_count": 13,
"shop_review_rating": 60,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.comspot.de",
"shop_name": "comspot.de"
},
{
"direct_sale": false,
"availability_text": "voraussichtlich verfügbar ab 17.03.2022",
"availability_code": "grey",
"voucher": false,
"free_return": "30",
"total": 629,
"shipping": 0,
"price": 629,
"currency": "EUR",
"position": "16",
"shop_review_count": 24376,
"shop_review_rating": 40,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.cyberport.de",
"shop_name": "cyberport.de"
},
{
"direct_sale": true,
"availability_text": "sofort lieferbar, Lieferung in 1-3 Werktagen",
"availability_code": "green",
"voucher": false,
"free_return": "14",
"total": 629.99,
"shipping": 0,
"price": 629.99,
"currency": "EUR",
"position": "17",
"shop_review_count": 12432,
"shop_review_rating": 40,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.saturn.de",
"shop_name": "saturn.de"
},
{
"direct_sale": false,
"availability_text": "sofort lieferbar, Lieferung in 1-3 Werktagen",
"availability_code": "green",
"voucher": false,
"free_return": "14",
"total": 629.99,
"shipping": 0,
"price": 629.99,
"currency": "EUR",
"position": "18",
"shop_review_count": 12432,
"shop_review_rating": 40,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.saturn.de",
"shop_name": "saturn.de"
},
{
"direct_sale": true,
"availability_text": "sofort lieferbar, Lieferung 1-3 Werktagen",
"availability_code": "green",
"voucher": false,
"free_return": "14",
"total": 629.99,
"shipping": 0,
"price": 629.99,
"currency": "EUR",
"position": "19",
"shop_review_count": 12153,
"shop_review_rating": 30,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.mediamarkt.de",
"shop_name": "mediamarkt.de"
},
{
"direct_sale": false,
"availability_text": "sofort lieferbar, Lieferung 1-3 Werktagen",
"availability_code": "green",
"voucher": false,
"free_return": "14",
"total": 629.99,
"shipping": 0,
"price": 629.99,
"currency": "EUR",
"position": "20",
"shop_review_count": 12153,
"shop_review_rating": 30,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.mediamarkt.de",
"shop_name": "mediamarkt.de"
}
],
"offers_count": 20,
"price_min": 550.96,
"price_max": 629.99,
"price_avg": 614.14,
"last_updated": "2022-02-17T01:33",
"available_since": "20201013",
"category_ids": [19116],
"categories": [
"Elektroartikel",
"Telekommunikation",
"Handys & Smartphones",
"Apple iPhone 12 mini",
"64GB Blau"
],
"review_count": 0,
"review_rating": 0,
"url": "https://www.idealo.de/preisvergleich/OffersOfProduct/200743988",
"name": "Apple iPhone 12 mini 64GB Blau",
"id": "200743988"
},
"success": true
},
{
"updated_at": "2022-02-17T13:44:33.596Z",
"query": {
"max_age": 1200,
"max_pages": 1,
"value": "0194252099537",
"key": "gtin",
"country": "de",
"topic": "search",
"source": "idealo"
},
"content": {
"offers": [
{
"direct_sale": false,
"availability_text": "Lieferung innerhalb von 2 - 4 Werktagen nach Zahlungseingang.",
"availability_code": "orange",
"voucher": true,
"free_return": "0",
"total": 617.49,
"shipping": 0,
"price": 617.49,
"currency": "EUR",
"position": "1",
"shop_review_count": 95260,
"shop_review_rating": 100,
"marketplace_name": "eBay",
"shop_type": "marketplace-shop",
"shop_url": "http://www.ebay.de/usr/mobile-online-shop",
"shop_name": "mobile-online-shop"
},
{
"direct_sale": false,
"availability_text": "Auf Lager, 1-2 Werktage",
"availability_code": "green",
"voucher": false,
"free_return": "100",
"total": 619.99,
"shipping": 0,
"price": 619.99,
"currency": "EUR",
"position": "2",
"shop_review_count": 538,
"shop_review_rating": 80,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.galaxus.de",
"shop_name": "galaxus.de"
},
{
"direct_sale": false,
"availability_text": "sofort lieferbar, Lieferung 1-3 Werktagen",
"availability_code": "green",
"voucher": false,
"free_return": "14",
"total": 619.99,
"shipping": 0,
"price": 619.99,
"currency": "EUR",
"position": "3",
"shop_review_count": 12153,
"shop_review_rating": 30,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.mediamarkt.de",
"shop_name": "mediamarkt.de"
},
{
"direct_sale": false,
"availability_text": "Auf Lager.. Express-Versand mit Amazon Prime möglich.",
"availability_code": "green",
"voucher": false,
"free_return": "30",
"total": 619.99,
"shipping": 0,
"price": 619.99,
"currency": "EUR",
"position": "4",
"shop_review_count": 1405,
"shop_review_rating": 40,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.amazon.de",
"shop_name": "Amazon"
},
{
"direct_sale": false,
"availability_text": "1 Werktage",
"availability_code": "green",
"voucher": false,
"free_return": "31",
"total": 628,
"shipping": 0,
"price": 628,
"currency": "EUR",
"position": "5",
"shop_review_count": 307,
"shop_review_rating": 90,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.gomibo.de",
"shop_name": "gomibo.de"
},
{
"direct_sale": false,
"availability_text": "lieferbar in ca. 6-8 Wochen",
"availability_code": "orange",
"voucher": false,
"free_return": "14",
"total": 629,
"shipping": 0,
"price": 629,
"currency": "EUR",
"position": "6",
"shop_review_count": 48,
"shop_review_rating": 90,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.shifter.shop",
"shop_name": "shifter.shop"
},
{
"direct_sale": false,
"availability_text": "lieferbar in ca. 6-8 Wochen",
"availability_code": "orange",
"voucher": false,
"free_return": "14",
"total": 629,
"shipping": 0,
"price": 629,
"currency": "EUR",
"position": "7",
"shop_review_count": 13,
"shop_review_rating": 60,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.comspot.de",
"shop_name": "comspot.de"
},
{
"direct_sale": false,
"availability_text": "Lieferzeit: 4-5 Werktage",
"availability_code": "orange",
"voucher": false,
"free_return": "14",
"total": 629,
"shipping": 0,
"price": 629,
"currency": "EUR",
"position": "8",
"shop_review_count": 10685,
"shop_review_rating": 80,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.alternate.de",
"shop_name": "alternate.de"
},
{
"direct_sale": false,
"availability_text": "voraussichtlich verfügbar ab 24.03.2022",
"availability_code": "grey",
"voucher": false,
"free_return": "30",
"total": 629,
"shipping": 0,
"price": 629,
"currency": "EUR",
"position": "9",
"shop_review_count": 24376,
"shop_review_rating": 40,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.cyberport.de",
"shop_name": "cyberport.de"
},
{
"direct_sale": false,
"availability_text": "lieferbar Ende März",
"availability_code": "grey",
"voucher": false,
"free_return": "30",
"total": 629,
"shipping": 0,
"price": 629,
"currency": "EUR",
"position": "10",
"shop_review_count": 11843,
"shop_review_rating": 80,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.otto.de",
"shop_name": "otto.de"
},
{
"direct_sale": false,
"availability_text": "Artikel ist sofort lieferbar",
"availability_code": "green",
"voucher": false,
"free_return": "28",
"total": 648.99,
"shipping": 0,
"price": 648.99,
"currency": "EUR",
"position": "11",
"shop_review_count": 5421,
"shop_review_rating": 100,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.bueroshop24.de",
"shop_name": "bueroshop24.de"
},
{
"direct_sale": false,
"availability_text": "Lieferung:\n \n \n Fr. 18.02.–Sa. 19.02.",
"availability_code": "green",
"voucher": false,
"free_return": "30",
"total": 649,
"shipping": 0,
"price": 649,
"currency": "EUR",
"position": "12",
"shop_review_count": 1376,
"shop_review_rating": 100,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.coolblue.de",
"shop_name": "coolblue.de"
},
{
"direct_sale": false,
"availability_text": "Lieferzeit 3-5 Werktage",
"availability_code": "orange",
"voucher": false,
"free_return": "30",
"total": 649,
"shipping": 0,
"price": 649,
"currency": "EUR",
"position": "13",
"shop_review_count": 25506,
"shop_review_rating": 90,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.computeruniverse.net",
"shop_name": "computeruniverse.net"
},
{
"direct_sale": false,
"availability_text": "Lieferzeit 2-3 Werktage",
"availability_code": "green",
"voucher": false,
"free_return": "14",
"total": 666.16,
"shipping": 0,
"price": 666.16,
"currency": "EUR",
"position": "14",
"shop_review_count": 10306,
"shop_review_rating": 90,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.jacob.de",
"shop_name": "jacob.de"
},
{
"direct_sale": false,
"availability_text": "Lieferung:\n \n \n Fr. 18.02.–Sa. 19.02.",
"availability_code": "green",
"voucher": false,
"free_return": "30",
"total": 667.49,
"shipping": 0,
"price": 667.49,
"currency": "EUR",
"position": "15",
"shop_review_count": 2329,
"shop_review_rating": 90,
"marketplace_name": "N/A",
"shop_type": "standalone-shop",
"shop_url": "http://www.clevertronic.de",
"shop_name": "clevertronic.de"
}
],
"offers_count": 15,
"price_min": 617.49,
"price_max": 667.49,
"price_avg": 635.41,
"last_updated": "2022-02-17T01:39",
"available_since": "20190910",
"category_ids": [19116],
"categories": [
"Elektroartikel",
"Telekommunikation",
"Handys & Smartphones",
"Apple iPhone 11",
"128GB White"
],
"review_count": 1,
"review_rating": 100,
"url": "https://www.idealo.de/preisvergleich/OffersOfProduct/6765271",
"name": "Apple iPhone 11 128GB White",
"id": "6765271"
},
"success": true
}
]
}
- Error Response:
Code: 200
Content:
OR{ "error": true, "message": "job id incorrect or missing" } - Code: 401 UNAUTHORIZED
OR - Code: 400 BAD REQUEST
OR - Code: 429 TOO MANY REQUESTS
OR - Code: 500 INTERNAL ERROR
List of possible errors:
- job not found - no job for given id
- job forbidden - not the job owner
List of possible product level errors:
- timeout - timeout expired before result was fetched
- not found - product was not found on the source
- parameter value invalid - invalid value (e.g. GTIN) supplied
- validation error - necessary value missing in data
- source currently unavailable - couldn’t collect data from source at the moment
Предыдущий Idealo response objects