{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab"]},"type":"markdown"},"seo":{"title":"Lidl","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":"lidl","__idx":0},"children":["Lidl"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Product data from ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lidl"]}," — a first-party retailer, so results carry Lidl's own price rather"," ","than a multi-seller offer list. Delivered via partner data feeds in kwery's normalized shape."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rolling out."]}," Lidl is onboarding now and is not yet enabled by default on new"," ","accounts. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://kwery.co/contact"},"children":["Contact us"]}," to be enabled as it goes live — the API"," ","shape documented on this page is final and will not change."]}]},{"$$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":["at"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["be"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bg"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ch"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cy"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cz"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["de"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dk"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ee"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["es"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fi"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fr"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gr"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hr"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hu"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ie"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["it"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lt"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lu"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lv"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mt"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nl"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pl"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pt"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ro"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rs"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["se"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["si"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sk"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uk"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lidl is a first-party retailer operating a searchable online shop across these 30 European"," ","markets; prices are returned in each market's local currency (EUR in most, with CHF, GBP, CZK,"," ","HUF, PLN, RON, BGN, RSD, SEK, and DKK in the respective non-euro markets). Lidl's remaining"," ","national sites (Bosnia-Herzegovina, North Macedonia) are corporate-only with no product"," ","catalog and are not available as sources."]},{"$$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":["Lidl product ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Direct product lookup."]}]}]}]}]},{"$$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 Lidl's price."]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lidl has no third-party seller list, so there is no ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search_and_offers"]}," topic — the price is"," ","Lidl's own (single first-party seller)."]}]},{"$$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"]},", price, availability, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["review_rating"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["review_count"]},". The single Lidl"," ","price is returned as the buy-box; there is no multi-seller ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offers[]"]},"."]},{"$$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\":\"lidl\",\"country\":\"de\",\"key\":\"term\",\"values\":[\"Parkside Akkuschrauber\"]}'\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: 'lidl', country: 'de', key: 'term', values: ['Parkside Akkuschrauber'] }),\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\": \"lidl\", \"country\": \"de\", \"key\": \"term\", \"values\": [\"Parkside Akkuschrauber\"]},\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: 'lidl', country: 'de', key: 'term', values: ['Parkside Akkuschrauber'] }),\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\":\"lidl\",\"country\":\"de\",\"key\":\"term\",\"values\":[\"Parkside Akkuschrauber\"]}',\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\":\"lidl\",\"country\":\"de\",\"key\":\"term\",\"values\":[\"Parkside Akkuschrauber\"]}`)\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\\\":\\\"lidl\\\",\\\"country\\\":\\\"de\\\",\\\"key\\\":\\\"term\\\",\\\"values\\\":[\\\"Parkside Akkuschrauber\\\"]}\"))\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\":\"lidl\",\"country\":\"de\",\"key\":\"term\",\"values\":[\"Parkside Akkuschrauber\"]}\"\"\",\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\":\"lidl\",\"country\":\"de\",\"key\":\"term\",\"values\":[\"Parkside Akkuschrauber\"]}'\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); a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["term"]}," search returns a list of product cards:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[\n  {\n    \"key\": \"Parkside Akkuschrauber\",\n    \"success\": true,\n    \"reason\": null,\n    \"content\": {\n      \"products\": [\n        {\n          \"name\": \"Parkside Akkuschrauber 20V\",\n          \"url\": \"https://www.lidl.de/p/1234567890\",\n          \"currency\": \"EUR\",\n          \"price\": 39.99,\n          \"availability\": \"in_stock\",\n          \"review_rating\": 4.2,\n          \"review_count\": 98\n        }\n      ]\n    }\n  }\n]\n","lang":"json"},"children":[]}]},"headings":[{"value":"Lidl","id":"lidl","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":"Lidl"}},"lastModified":"2026-08-25T12:32:20.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/sources/lidl","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}