{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab"]},"type":"markdown"},"seo":{"title":"Guenstiger","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":"guenstiger","__idx":0},"children":["Guenstiger"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Price-comparison data from ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["guenstiger.de"]}," — a product with its full list of seller offers."]},{"$$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":"p","attributes":{},"children":["Guenstiger is a single-market source (guenstiger.de)."]},{"$$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":["guenstiger.de 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":["Resolved to the matching product, then fetched. A GTIN may also resolve directly to a set of offers when no distinct product page exists."]}]}]}]}]},{"$$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, including the lead (cheapest) offer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search_and_offers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Also fetches the full per-seller offer list."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"fields","level":2,"__idx":4},"children":["Response "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns the standard normalized ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["content"]}," object (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/sources#how-to-read-the-field-tables"},"children":["Sources overview"]},"):"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]},", ",{"$$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":"code","attributes":{},"children":["offers_count"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offers[]"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["review_rating"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["review_count"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As a price-comparison source, the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["per-seller offer list"]}," is the main payload: with"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search_and_offers"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offers[]"]}," carries each seller's name, price, currency, and shipping."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"example","level":2,"__idx":5},"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\":\"guenstiger\",\"country\":\"de\",\"key\":\"term\",\"topic\":\"search_and_offers\",\"values\":[\"Tissot T-Touch Expert Solar\"]}'\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: 'guenstiger', country: 'de', key: 'term', topic: 'search_and_offers', values: ['Tissot T-Touch Expert Solar'] }),\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\": \"guenstiger\", \"country\": \"de\", \"key\": \"term\", \"topic\": \"search_and_offers\", \"values\": [\"Tissot T-Touch Expert Solar\"]},\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: 'guenstiger', country: 'de', key: 'term', topic: 'search_and_offers', values: ['Tissot T-Touch Expert Solar'] }),\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\":\"guenstiger\",\"country\":\"de\",\"key\":\"term\",\"topic\":\"search_and_offers\",\"values\":[\"Tissot T-Touch Expert Solar\"]}',\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\":\"guenstiger\",\"country\":\"de\",\"key\":\"term\",\"topic\":\"search_and_offers\",\"values\":[\"Tissot T-Touch Expert Solar\"]}`)\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\\\":\\\"guenstiger\\\",\\\"country\\\":\\\"de\\\",\\\"key\\\":\\\"term\\\",\\\"topic\\\":\\\"search_and_offers\\\",\\\"values\\\":[\\\"Tissot T-Touch Expert Solar\\\"]}\"))\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\":\"guenstiger\",\"country\":\"de\",\"key\":\"term\",\"topic\":\"search_and_offers\",\"values\":[\"Tissot T-Touch Expert Solar\"]}\"\"\",\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\":\"guenstiger\",\"country\":\"de\",\"key\":\"term\",\"topic\":\"search_and_offers\",\"values\":[\"Tissot T-Touch Expert Solar\"]}'\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":6},"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\": \"Tissot T-Touch Expert Solar\",\n    \"success\": true,\n    \"reason\": null,\n    \"content\": {\n      \"name\": \"Tissot T-Touch Expert Solar\",\n      \"url\": \"https://www.guenstiger.de/product/1234567890\",\n      \"currency\": \"EUR\",\n      \"price_min\": 799.00,\n      \"price_avg\": 849.50,\n      \"price_max\": 899.00,\n      \"offers_count\": 2,\n      \"offers\": [\n        { \"shop_name\": \"watch-shop-de\", \"price\": 799.00, \"currency\": \"EUR\", \"shipping\": 0 },\n        { \"shop_name\": \"uhrencenter24\", \"price\": 899.00, \"currency\": \"EUR\", \"shipping\": 4.95 }\n      ],\n      \"review_rating\": 4.3,\n      \"review_count\": 56\n    }\n  }\n]\n","lang":"json"},"children":[]}]},"headings":[{"value":"Guenstiger","id":"guenstiger","depth":1},{"value":"Supported countries","id":"countries","depth":2},{"value":"Keys","id":"keys","depth":2},{"value":"Topics","id":"topics","depth":2},{"value":"Response","id":"fields","depth":2},{"value":"Example request","id":"example","depth":2},{"value":"Example response","id":"example-response","depth":2}],"frontmatter":{"seo":{"title":"Guenstiger"}},"lastModified":"2026-08-18T06:09:24.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/sources/guenstiger","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}