--- title: "eBay API: JSON data, 3 endpoints, 1 credit per call" description: "Get eBay data as structured JSON with one API key: search, item and autocomplete. Free credits every month." url: https://perceptlayer.com/apis/ebay --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / eBay 1 credit per call 3 endpoints 8 datapoints # eBay API Get eBay data as structured JSON with one API key: search, item and autocomplete. Free credits every month. [Get a free API key](https://perceptlayer.com/signup) Run it below eBay GET /v1/ebay/search?q=coffee+maker&page=1&per\_page=60 ``` { "success": true, "data": { "query": "coffee maker", "page": 1, "per_page": 60, "has_more": true, "results": [ { "product_id": "366702966104", "title": "Mr. Coffee 4-in-1 Single-Serve Latte, Iced, and Hot Coffee", "link": "https://www.ebay.com/itm/366702966104", "price": { "raw": "$60.00", "extracted": 60, "currency": "USD" }, "sponsored": true, "subtitle": "Brand New", "thumbnail": "https://i.ebayimg.com/images/g/fhEAAeSwuP5qvcJe/s-l500.webp", "location": "United States" }, { "product_id": "167322718667", "title": "New Keurig Green Mountain K4000 Cafe System Commercial K-Cup Coffee Maker", "link": "https://www.ebay.com/itm/167322718667", "price": { "raw": "$428.98", "extracted": 428.98, "currency": "USD" }, "sponsored": true, "subtitle": "Brand New", "thumbnail": "https://i.ebayimg.com/images/g/UVIAAOSwdnFnmqXS/s-l500.webp", "location": "United States" }, { "product_id": "155542047462", "title": "Makita Rechargeable Coffee Maker 18V CM500DZ Body ONLY New No Battery", "link": "https://www.ebay.com/itm/155542047462", "price": { "raw": "$74.67", "extracted": 74.67, "currency": "USD" }, "sponsored": true, "subtitle": "Brand New", "thumbnail": "https://i.ebayimg.com/images/g/bIEAAOSw6DVkV0Xq/s-l140.webp", "shipping": { "raw": "+$3.00 delivery", "extracted": 3, "currency": "USD" }, "location": "Japan", "quantity_sold": 31 } ], "total_results": 110000, "related_searches": [ { "query": "keurig coffee maker", "link": "https://www.ebay.com/sch/i.html?_nkw=keurig+coffee+maker&_sop=12" }, { "query": "coffee maker 12 cup", "link": "https://www.ebay.com/sch/i.html?_nkw=coffee+maker+12+cup&_sop=12" }, { "query": "coffee machine", "link": "https://www.ebay.com/sch/i.html?_nkw=coffee+machine&_sop=12" } ], "categories": [ { "id": 11700, "name": "Home & Garden" }, { "id": 20625, "name": "Kitchen, Dining & Bar" }, { "id": 20667, "name": "Small Kitchen Appliances" } ] }, "meta": { "endpoint_family": "search", "duration_ms": 2866 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | product\_id string | title string | link url | price object | sponsored boolean | subtitle string | thumbnail url | location string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 366702966104 | Mr. Coffee 4-in-1 Single-Serve Latte, Iced, and Hot Coffee | https://www.ebay.com/itm/366702966104 | {3 fields} | true | Brand New | https://i.ebayimg.com/images/g/fhEAAeSwuP5qvcJe/s-l500.webp | United States | | 2 | 167322718667 | New Keurig Green Mountain K4000 Cafe System Commercial K-Cup Coffee Maker | https://www.ebay.com/itm/167322718667 | {3 fields} | true | Brand New | https://i.ebayimg.com/images/g/UVIAAOSwdnFnmqXS/s-l500.webp | United States | | 3 | 155542047462 | Makita Rechargeable Coffee Maker 18V CM500DZ Body ONLY New No Battery | https://www.ebay.com/itm/155542047462 | {3 fields} | true | Brand New | https://i.ebayimg.com/images/g/bIEAAOSw6DVkV0Xq/s-l140.webp | Japan | Recorded from our API · 3 items shown · 8 datapoints per item GET /v1/ebay/search?q=coffee+maker&page=1&per\_page=60 8 datapoints ### Identity - product\_id string - title string - subtitle string ### Contact - link url ### Location - location string ### Price - price object ### Other - sponsored boolean - thumbnail url Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/ebay/search?q=coffee+maker&page=1&per_page=60" \ -H "X-API-Key: $API_KEY" ``` eBay · 3 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/ebay/autocomplete`](https://perceptlayer.com/apis/ebay/autocomplete) | `q` | 1 credit | | [GET `/v1/ebay/item`](https://perceptlayer.com/apis/ebay/item) | `item_id` | 1 credit | | [GET `/v1/ebay/search`](https://perceptlayer.com/apis/ebay/search) | `q` +12 optional | 1 credit | Overview ## About the eBay API ## What you can get The eBay API returns search, item and autocomplete as clean JSON. Each successful call costs one credit, and calls that fail are free. Marketplaces JSON REST MCP ### More marketplaces APIs [AliExpress](https://perceptlayer.com/apis/aliexpress) [Billiger.de](https://perceptlayer.com/apis/billiger) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) [Depop](https://perceptlayer.com/apis/depop) [Dubizzle](https://perceptlayer.com/apis/dubizzle) [FINN](https://perceptlayer.com/apis/finn) [Geizhals](https://perceptlayer.com/apis/geizhals) [Gumtree](https://perceptlayer.com/apis/gumtree) [Idealo](https://perceptlayer.com/apis/idealo) [Kijiji](https://perceptlayer.com/apis/kijiji) [Kleinanzeigen](https://perceptlayer.com/apis/kleinanzeigen) Use cases ### Track competitor prices and stock `Use the eBay API to track competitor prices and stock` ### Enrich your product catalogue `Use the eBay API to enrich your product catalogue` ### Research sellers and categories `Use the eBay API to research sellers and categories` FAQ ## Questions **How much does the eBay API cost?** Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Do I need a separate key for eBay?** No. One key works for every API in the catalogue. ## Try the eBay API with 1,000 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://perceptlayer.com/docs)