APIs / Marketplaces / eBay
1 credit per call3 endpoints8 datapoints
eBay API
Get eBay data as structured JSON with one API key: search, item and autocomplete. Free credits every month.
{
"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
}
}Sample data
What one call returns
A recorded run of search: the fields and shapes you will get, shortened to 3 items.
| # | product_idstring | titlestring | linkurl | priceobject | sponsoredboolean | subtitlestring | thumbnailurl | locationstring |
|---|---|---|---|---|---|---|---|---|
| 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 |
[
{
"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
}
]product_id,title,link,price,sponsored,subtitle,thumbnail,location
366702966104,"Mr. Coffee 4-in-1 Single-Serve Latte, Iced, and Hot Coffee",https://www.ebay.com/itm/366702966104,"{""raw"":""$60.00"",""extracted"":60,""currency"":""USD""}",true,Brand New,https://i.ebayimg.com/images/g/fhEAAeSwuP5qvcJe/s-l500.webp,United States
167322718667,New Keurig Green Mountain K4000 Cafe System Commercial K-Cup Coffee Maker,https://www.ebay.com/itm/167322718667,"{""raw"":""$428.98"",""extracted"":428.98,""currency"":""USD""}",true,Brand New,https://i.ebayimg.com/images/g/UVIAAOSwdnFnmqXS/s-l500.webp,United States
155542047462,Makita Rechargeable Coffee Maker 18V CM500DZ Body ONLY New No Battery,https://www.ebay.com/itm/155542047462,"{""raw"":""$74.67"",""extracted"":74.67,""currency"":""USD""}",true,Brand New,https://i.ebayimg.com/images/g/bIEAAOSw6DVkV0Xq/s-l140.webp,JapanRecorded from our API · 3 items shown · 8 datapoints per itemGET /v1/ebay/search?q=coffee+maker&page=1&per_page=60
8 datapoints
Identity
- product_idstring
- titlestring
- subtitlestring
Contact
- linkurl
Location
- locationstring
Price
- priceobject
Other
- sponsoredboolean
- thumbnailurl
Playground
Run this API
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 | q | 1 credit |
GET/v1/ebay/item | item_id | 1 credit |
GET/v1/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.
More marketplaces APIs
Use cases
Track competitor prices and stock
Use the eBay API to track competitor prices and stockEnrich your product catalogue
Use the eBay API to enrich your product catalogueResearch sellers and categories
Use the eBay API to research sellers and categoriesFAQ
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.