Get eBay data with one API
The eBay API returns active listings, sold prices and seller data as clean JSON.
7 active endpoints, on 1, 2 and 3 credit tiers.
- POST/ebay/v1/search
- POST/ebay/v1/item_detail
- POST/ebay/v1/items_batch
- POST/ebay/v1/seller_items
- POST/ebay/v1/seller_profile
- POST/ebay/v1/deals
- POST/ebay/v1/categories
What eBay endpoints does ReefAPI ship?
7 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
eBay API
2 of 7 endpoints, ready to run
active-listing search by query -> results[]{item_id,title,price{value,currency},condition,buy…
{ "ok": true, "meta": { "api": "ebay", "endpoint": "search", "mode": "live", "latency_ms": 2838.5, "record_count": 60, "cache_hit": false }, "data": { "query": "iphone 13 pro", "results": [ { "item_id": "226523060489", "title": "Apple iPhone 13 128GB Fully Unlocked - Very Good Condition", "price": { "raw": "$249.99", "value": 249.99, "currency": "USD" }, "condition": "1 YEAR WARRANTY🔥 FREE RETURNS🔥FREE 2 DAY SHIPPING", "buying_format": "Buy It Now", "shipping": "Free delivery in 2-3 days", "location": "United States", "image": "https://i.ebayimg.com/images/g/uVoAAOSwNx1lxQnL/s-l500.webp", "url": "https://www.ebay.com/itm/226523060489", "sold_count": "373+ sold", "catalog_rating": { "average": 4.5, "review_count": 0 } }, { "item_id": "286910053729", "title": "Apple iPhone 13 128GB 256GB 512GB Verizon AT&T T-Mobile Unlocked (Good)", "price": { "raw": "$223.99", "value": 223.99, "currency": "USD" }, "condition": "Pre-Owned", "buying_format": "Buy It Now", "shipping": "Free delivery", "location": "United States", "image": "https://i.ebayimg.com/images/g/ic8AAeSwVeRpcwzG/s-l500.webp", "url": "https://www.ebay.com/itm/286910053729", "catalog_rating": { "average": 4.5, "review_count": 0 } }, { "item_id": "128012807768", "title": "Apple iPhone 13 A2482 128GB Unlocked Very Good Condition All Colors", "price": { "raw": "$299.86", "value": 299.86, "currency": "USD" }, "condition": "Very Good - Refurbished", "buying_format": "Buy It Now", "shipping": "Free delivery in 2-3 days", "location": "United States", "image": "https://i.ebayimg.com/images/g/Sm4AAeSwwbZqc7Fc/s-l500.webp", "url": "https://www.ebay.com/itm/128012807768", "sold_count": "153+ sold", "catalog_rating": { "average": 4.5, "review_count": 0 } } ] } }
How the eBay API works
eBay is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 185 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
eBay marketplaces: the domain parameter, and the currency each one returns
This API does not use site codes like EBAY_US or numeric site ids. It takes a domain parameter whose value is the eBay hostname suffix, and that choice sets the currency and the local listing pool. Every row below was measured on 2026-08-27 by running the same search once per domain and reading the currency and the raw price string off the first result.
| domain | Site | Currency returned | Raw price string measured |
|---|---|---|---|
| com | ebay.com, United States | USD | $39.99 |
| co.uk | ebay.co.uk, United Kingdom | GBP | £4.95 |
| de | ebay.de, Germany | EUR | EUR 29,00 |
| fr | ebay.fr, France | EUR | 71,40 EUR |
| it | ebay.it, Italy | EUR | EUR 29,99 |
| es | ebay.es, Spain | EUR | 65,00 EUR |
| ca | ebay.ca, Canada | CAD | C $11.26 |
| com.au | ebay.com.au, Australia | AUD | AU $335.99 |
| ch | ebay.ch, Switzerland | CHF | CHF 207,37 |
| pl | ebay.pl, Poland | PLN | 30,08 zl |
| com.sg | ebay.com.sg, Singapore | SGD | S$ 135.95 |
| com.hk | ebay.com.hk, Hong Kong | HKD | HK$ 63.97 |
nl, at and ie also answered and all three returned EUR; they are left out only to keep the table short. com.sg and com.hk are not in the parameter's dropdown but were accepted and answered, so other eBay country hosts are worth trying. The raw string is formatted per site (EUR 29,00 on de but 71,40 EUR on fr), so read price.value, which is the parsed number. All 15 domains returned 12-digit item ids.
What people build with eBay
The jobs this data is most often used for.
endpoints
credits per call
Resale-pricing tools call sold_search to find an item's true market value from completed sales.
Marketplace analysts use search and deals to track active-listing prices and promotions.
Seller-intelligence products use seller_items and seller_profile to audit a competitor's full inventory.
What eBay data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 185 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/ebay/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 13 pro"}'import requests
r = requests.post(
"https://api.reefapi.com/ebay/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone 13 pro"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up eBay.
Get a free key →What marketplace code do I pass, EBAY_US or a numeric site id?▾
Neither. The parameter is domain and its value is the eBay hostname suffix: com, co.uk, de, fr, it, es, nl, at, ie, ca, com.au, ch, pl. All 13 were live-verified, and com.sg and com.hk were accepted too even though they are not in the dropdown. domain defaults to com, and an unrecognized value is ignored rather than rejected, so a typo silently gives you ebay.com results.
How long is an eBay item id?▾
Every id measured was 12 digits, on all 15 domains tried on 2026-08-27, for example 389734331119 on com, 336311417494 on co.uk and 820051316593 on nl. It is the number after /itm/ in the listing URL. item_detail takes either item_id or the full url, and items_batch takes a list of ids.
Why do I filter on condition=used but get back "Pre-Owned"?▾
The filter takes an enum (new, open_box, refurbished, used, for_parts) but the response carries eBay's display label. In search the same items came back as "Pre-Owned" and "Brand new"; in item_detail those same listings read "Used", "New" and "Refurbished". Neither set is a stable enum, so map on your side and do not string-compare responses against filter values.
Why is shipping a string in search but a number in item_detail?▾
search returns eBay's rendered label, for example "+$5.68 delivery", because that is what the results grid publishes. item_detail returns a structured block instead, {rate: 5.93, currency: "USD", country: "USA"}. On several listings item_detail's shipping came back null while search had a label for the same item, so if you need a shipping figure on every row, take it from search.
What does buying_format tell me, and can I trust the auction fields?▾
In search, buying_format is eBay's own grid label and it is reliable: measured values include "Buy It Now", "or Best Offer", "0 bids" and "20 bids". In item_detail the buying_format, bids and current_bid fields are currently not trustworthy. On 2026-08-27 four fixed-price listings that search labelled "Buy It Now" or "or Best Offer" came back from item_detail as buying_format "auction" with bids 1 and current_bid equal to the fixed price. Until that is corrected, take the format from search and use item_detail for end_time, watchers, quantity_sold and best_offer.
Which item_detail fields come back null?▾
seller.feedback_pct and seller.feedback_count were null on every item measured, and seller was null entirely on some listings. category_path was populated on co.uk items and null on ebay.com items in the same batch. return_policy is null unless the seller published one, list_price is null unless the listing shows a strikethrough price, and time_left is either null or the untranslated stub "Ends in". Use end_time, which is a clean ISO timestamp such as 2026-09-12T19:55:43.000Z.
Does items_batch cost less than calling item_detail repeatedly?▾
No. eBay has no batched item endpoint, so items_batch fans out into one request per id and says so in meta: requested 3, upstream_calls 3, concurrency 8, and billing_note "priced per item id, not per call". What you save is round trips and wall time, not credits. The response splits into items, not_found and unavailable, so one dead id does not kill the whole call.
Why does sold_search return an error?▾
It is switched off at the moment. Measured on 2026-08-27, sold_search returned ok:false with error.code DISABLED, retryable:false, and meta.scope ENDPOINT_DISABLED. It fails immediately rather than hanging, so a retry loop will not help. search, item_detail, items_batch, seller_items, seller_profile, deals and categories were all answering normally on the same day.
What is the eBay API?▾
eBay API is a ReefAPI endpoint group for active listings plus sold prices and market stats. It returns live JSON through POST requests under /ebay/v1.
Is the eBay API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. eBay calls use the same shared credit balance as every other ReefAPI engine.
Do I need an eBay login or account?▾
No login to eBay is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the eBay data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the eBay API use?▾
eBay actions currently cost 1-3 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call eBay from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call ebay actions with the same key, credit pool and JSON envelope used by normal REST requests.
37 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling eBay, you are one call away from the rest of the category — no second contract, no second integration.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 184 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts.