{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab"]},"type":"markdown"},"seo":{"title":"eBay","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":"ebay","__idx":0},"children":["eBay"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["eBay listing data. Search by keyword or GTIN, or look up a specific item 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":["au"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["at"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["be"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ca"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fr"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["de"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ie"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["it"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hk"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["my"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nl"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pl"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sg"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["es"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ch"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uk (gb)"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["us"]}]},{"$$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":["eBay item ID (numeric)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Direct item 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":"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":["Item / listing data."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"fields","level":2,"__idx":4},"children":["Product ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["content"]}," fields "]},{"$$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":["eBay item 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":["Listing title."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Item price."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO currency."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipping"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shipping cost."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipping"]},"."]}]},{"$$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 name."]}]},{"$$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 vs. standalone 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":"p","attributes":{},"children":["A keyword/GTIN search returns price aggregates (",{"$$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"]},", and an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offers[]"]}," list; an item lookup returns the single-listing fields above."]},{"$$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\":\"ebay\",\"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: 'ebay', 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\": \"ebay\", \"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: 'ebay', 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\":\"ebay\",\"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\":\"ebay\",\"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\\\":\\\"ebay\\\",\\\"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\":\"ebay\",\"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\":\"ebay\",\"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":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\": \"4006381333962\",\n    \"success\": true,\n    \"reason\": null,\n    \"content\": {\n      \"name\": \"STABILO point 88 fineliner\",\n      \"currency\": \"EUR\",\n      \"price_min\": 12.49,\n      \"price_avg\": 13.99,\n      \"price_max\": 15.49,\n      \"offers_count\": 2,\n      \"offers\": [\n        { \"id\": \"1234567890\", \"shop_name\": \"office-supplies-de\", \"shop_type\": \"marketplace shop\", \"price\": 12.49, \"currency\": \"EUR\", \"shipping\": 2.99, \"total\": 15.48 },\n        { \"id\": \"2345678901\", \"shop_name\": \"papershop24\", \"shop_type\": \"standalone shop\", \"price\": 15.49, \"currency\": \"EUR\", \"shipping\": 0, \"total\": 15.49 }\n      ]\n    }\n  }\n]\n","lang":"json"},"children":[]}]},"headings":[{"value":"eBay","id":"ebay","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":"Example request","id":"example","depth":2},{"value":"Example response","id":"example-response","depth":2}],"frontmatter":{"seo":{"title":"eBay"}},"lastModified":"2026-08-18T06:09:24.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/sources/ebay","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}