{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab"]},"type":"markdown"},"seo":{"title":"Idealo","description":"Real-time price and offer data across major marketplaces."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"idealo","__idx":0},"children":["Idealo"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Idealo price-comparison data, with the richest seller-offer detail of any source. Search by"," ","keyword, GTIN, pharmacy number (PZN), or look up an Idealo product by ID."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"countries","level":2,"__idx":1},"children":["Supported countries "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}," accepts: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["de"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["at"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uk (gb)"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fr"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["it"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["es"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uk"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gb"]}," are two codes for the same UK marketplace — not a separate locale."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"keys","level":2,"__idx":2},"children":["Keys "]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Key"},"children":["Key"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Values"},"children":["Values"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["term"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Free text"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Keyword search."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Idealo product ID (numeric)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Direct product lookup."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gtin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EAN / GTIN-13"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GTIN search."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pzn"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pharmacy product number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["German pharmacy lookup (de)."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"topics","level":2,"__idx":3},"children":["Topics "]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Topic"},"children":["Topic"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}," (default)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product page with the full offer list."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"fields","level":2,"__idx":4},"children":["Product ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["content"]}," fields "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Product results (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gtin"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pzn"]},") are sourced from Idealo's offer-list endpoint and"," ","focus on offers. Page-only metadata — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["available_since"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_updated"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["review_rating"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["review_count"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["energy_efficiency"]}," — is not included in product results (it remains"," ","available on keyword ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}," results, where present)."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Idealo product ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product title."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product URL."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["categories"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Category name(s). Populated for German-market results (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["de"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["at"]},"); empty for other locales."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["category_ids"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Primary category id(s) for the product."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price_min"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price_avg"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price_max"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Offer price aggregates."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offers_count"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number of offers gathered."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seller offers — see below."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["energy_efficiency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EU energy efficiency class, where present: one of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A+++"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A++"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A+"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["B"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["C"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["D"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["E"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["F"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["G"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," when not applicable/available. Keyword ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}," results only — see note above."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"offer-fields","level":3,"__idx":5},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offers[]"]}," fields "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Idealo offers carry detailed seller and listing metadata, which may include:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shop_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seller / shop name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketplace_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Marketplace, when the offer is via a marketplace seller."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shop_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seller type (e.g. marketplace shop)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shop_url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seller URL."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shop_review_rating"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shop_review_count"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seller review signal."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["position"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Offer position in the list."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["condition"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Item condition."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["voucher"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Voucher/discount info, when present."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["availability_code"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["availability_text"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Availability."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["direct_sale"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether the offer is a direct sale."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_return"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether free returns are offered."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["energy_efficiency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EU energy efficiency class for this offer, where present: one of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A+++"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A++"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A+"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["B"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["C"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["D"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["E"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["F"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["G"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," when not applicable/available."]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some seller names require an extra resolution step. With seller-name resolution enabled on"," ","your account, kwery fills these in for you — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/sources#seller-name-resolution"},"children":["Sources › Seller-name"," ","resolution"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"example","level":2,"__idx":6},"children":["Example request "]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"cURL","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -s https://api.kwery.co/job \\\n  -H \"Authorization: Bearer $KWERY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"source\":\"idealo\",\"country\":\"de\",\"key\":\"gtin\",\"values\":[\"4006381333962\"]}'\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Node.js","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"js","header":{"controls":{"copy":{}}},"source":"const res = await fetch('https://api.kwery.co/job', {\n  method: 'POST',\n  headers: {\n    'Authorization': `Bearer ${process.env.KWERY_API_KEY}`,\n    'Content-Type': 'application/json',\n  },\n  body: JSON.stringify({ source: 'idealo', country: 'de', key: 'gtin', values: ['4006381333962'] }),\n});\nconst data = await res.json();\nif (data.error) throw new Error(data.message);\nconsole.log('job id:', data.job._id);\n","lang":"js"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Python","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","header":{"controls":{"copy":{}}},"source":"import os, requests\n\nres = requests.post(\n    \"https://api.kwery.co/job\",\n    headers={\"Authorization\": f\"Bearer {os.environ['KWERY_API_KEY']}\"},\n    json={\"source\": \"idealo\", \"country\": \"de\", \"key\": \"gtin\", \"values\": [\"4006381333962\"]},\n)\ndata = res.json()\nif data.get(\"error\"):\n    raise RuntimeError(data[\"message\"])\nprint(\"job id:\", data[\"job\"][\"_id\"])\n","lang":"python"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"JavaScript","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"js","header":{"controls":{"copy":{}}},"source":"const res = await fetch('https://api.kwery.co/job', {\n  method: 'POST',\n  headers: { 'Authorization': `Bearer ${KWERY_API_KEY}`, 'Content-Type': 'application/json' },\n  body: JSON.stringify({ source: 'idealo', country: 'de', key: 'gtin', values: ['4006381333962'] }),\n});\nconst data = await res.json();\nif (data.error) throw new Error(data.message);\nconsole.log('job id:', data.job._id);\n","lang":"js"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"PHP","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"php","header":{"controls":{"copy":{}}},"source":"<?php\n$ch = curl_init('https://api.kwery.co/job');\ncurl_setopt_array($ch, [\n  CURLOPT_RETURNTRANSFER => true,\n  CURLOPT_POST => true,\n  CURLOPT_HTTPHEADER => [\n    'Authorization: Bearer ' . getenv('KWERY_API_KEY'),\n    'Content-Type: application/json',\n  ],\n  CURLOPT_POSTFIELDS => '{\"source\":\"idealo\",\"country\":\"de\",\"key\":\"gtin\",\"values\":[\"4006381333962\"]}',\n]);\n$data = json_decode(curl_exec($ch), true);\nif ($data['error']) { throw new Exception($data['message']); }\necho 'job id: ' . $data['job']['_id'];\n","lang":"php"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Go","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"go","header":{"controls":{"copy":{}}},"source":"package main\n\nimport (\n\t\"bytes\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbody := []byte(`{\"source\":\"idealo\",\"country\":\"de\",\"key\":\"gtin\",\"values\":[\"4006381333962\"]}`)\n\treq, _ := http.NewRequest(\"POST\", \"https://api.kwery.co/job\", bytes.NewBuffer(body))\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"KWERY_API_KEY\"))\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\tresp, err := http.DefaultClient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer resp.Body.Close()\n\tvar data map[string]any\n\tjson.NewDecoder(resp.Body).Decode(&data)\n\tfmt.Println(\"job:\", data[\"job\"])\n}\n","lang":"go"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Java","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"java","header":{"controls":{"copy":{}}},"source":"var client = java.net.http.HttpClient.newHttpClient();\nvar request = java.net.http.HttpRequest.newBuilder()\n    .uri(java.net.URI.create(\"https://api.kwery.co/job\"))\n    .header(\"Authorization\", \"Bearer \" + System.getenv(\"KWERY_API_KEY\"))\n    .header(\"Content-Type\", \"application/json\")\n    .POST(java.net.http.HttpRequest.BodyPublishers.ofString(\n        \"{\\\"source\\\":\\\"idealo\\\",\\\"country\\\":\\\"de\\\",\\\"key\\\":\\\"gtin\\\",\\\"values\\\":[\\\"4006381333962\\\"]}\"))\n    .build();\nvar response = client.send(request, java.net.http.HttpResponse.BodyHandlers.ofString());\nSystem.out.println(response.body());\n","lang":"java"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"C#","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"csharp","header":{"controls":{"copy":{}}},"source":"using var client = new HttpClient();\nclient.DefaultRequestHeaders.Add(\"Authorization\",\n    $\"Bearer {Environment.GetEnvironmentVariable(\"KWERY_API_KEY\")}\");\nvar body = new StringContent(\n    \"\"\"{\"source\":\"idealo\",\"country\":\"de\",\"key\":\"gtin\",\"values\":[\"4006381333962\"]}\"\"\",\n    System.Text.Encoding.UTF8, \"application/json\");\nvar response = await client.PostAsync(\"https://api.kwery.co/job\", body);\nConsole.WriteLine(await response.Content.ReadAsStringAsync());\n","lang":"csharp"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Ruby","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","header":{"controls":{"copy":{}}},"source":"require 'net/http'\nrequire 'json'\n\nuri = URI('https://api.kwery.co/job')\nreq = Net::HTTP::Post.new(uri, {\n  'Authorization' => \"Bearer #{ENV['KWERY_API_KEY']}\",\n  'Content-Type' => 'application/json',\n})\nreq.body = '{\"source\":\"idealo\",\"country\":\"de\",\"key\":\"gtin\",\"values\":[\"4006381333962\"]}'\ndata = JSON.parse(Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }.body)\nraise data['message'] if data['error']\nputs \"job id: #{data['job']['_id']}\"\n","lang":"ruby"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"example-response","level":2,"__idx":7},"children":["Example response "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Results are fetched with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /job/{id}/download"]}," once the job is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finished"]}," — each entry is the result for one input value (abridged):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[\n  {\n    \"key\": \"4006381333962\",\n    \"success\": true,\n    \"reason\": null,\n    \"content\": {\n      \"id\": \"1234567890\",\n      \"name\": \"STABILO point 88 fineliner\",\n      \"url\": \"https://www.idealo.de/preisvergleich/OffersOfProduct/1234567890.html\",\n      \"categories\": [\"Schreibwaren\"],\n      \"category_ids\": [\"12345\"],\n      \"price_min\": 12.49,\n      \"price_avg\": 13.99,\n      \"price_max\": 15.49,\n      \"offers_count\": 2,\n      \"offers\": [\n        { \"shop_name\": \"office-supplies-de\", \"shop_type\": \"marketplace shop\", \"position\": 1, \"condition\": \"new\", \"availability_code\": \"available\", \"availability_text\": \"in stock\", \"direct_sale\": true, \"free_return\": true },\n        { \"shop_name\": \"papershop24\", \"shop_type\": \"standalone shop\", \"position\": 2, \"condition\": \"new\" }\n      ]\n    }\n  }\n]\n","lang":"json"},"children":[]}]},"headings":[{"value":"Idealo","id":"idealo","depth":1},{"value":"Supported countries","id":"countries","depth":2},{"value":"Keys","id":"keys","depth":2},{"value":"Topics","id":"topics","depth":2},{"value":"Product content fields","id":"fields","depth":2},{"value":"offers[] fields","id":"offer-fields","depth":3},{"value":"Example request","id":"example","depth":2},{"value":"Example response","id":"example-response","depth":2}],"frontmatter":{"seo":{"title":"Idealo"}},"lastModified":"2026-08-18T06:09:24.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/sources/idealo","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}