Get full eBay listing details by item ID or listing URL, including price, seller, shipping, returns and item specifics.
View all eBay Product Listings & Seller Data endpoints →Returns the full detail record for a single eBay listing, identified by item_id (the digits after /itm/ in the listing URL) or by the complete listing url; provide one of the two. domain selects one of 13 verified eBay sites (com, co.uk, de, com.au, ca, fr, it, es, nl, at, ch, ie, pl), and include_description set to true inlines the full seller description text at the cost of one extra request. The response uses an ok/meta/data envelope and data.item carries the listing. Observed in a live probe (item_id 287070621317, domain com): item_id, title, url, price{value, currency, raw}, list_price, condition, availability, brand, model, mpn, images[] (url, width, height and sometimes a description), item_specifics{} with 22 entries, seller{name, feedback_pct, feedback_count}, shipping{country, currency, rate}, return_policy{days, method}, best_offer, quantity_available, quantity_sold, watchers, end_time, attributes{dimensions, weight} and description_url. In that sample seller.feedback_pct, seller.feedback_count, category_path and both attributes values were null. Documented but not exercised by the probe listing: bids, current_bid and time_left for auctions, variations[]{dimension, values[]{value, out_of_stock}} for multi-variation listings, and a description field when include_description is set.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/ebay/item-detail API Response (JSON)
{} curl -X POST 'https://api.opendata-api.com/api/project/ebay/item-detail?key=<API_KEY>'
Query Result
Use Cases
- Watch variant-level stock for sizes and colors by polling variations[].values[].out_of_stock on a multi-variation listing
- Enrich a product catalog with brand, model, MPN, category path and item specifics when matching marketplace listings to internal SKUs
- Track an auction on a schedule by reading current_bid, bids, time_left and end_time until it closes
- Audit a listing by setting include_description and scanning the seller description text for required or prohibited phrases
- Compare shipping rate and return window across competing listings of the same product before choosing a supplier
- Add a paste-a-listing-link lookup to a chat bot or browser extension using the url parameter instead of an item ID
- Log watchers and quantity_sold over time to estimate demand for a specific listing
Frequently asked questions
Should I send item_id or url?
Either one. item_id is the number after /itm/ in the listing address, and url accepts the full listing link. The API documentation says one of the two is required, even though both are optional in the schema, so a request with neither should not be sent.
What does include_description do?
Setting it to true also fetches and inlines the full seller description text, at the cost of one extra request, so it is off by default. In the probe without it, the item came back with a description_url instead.
Which fields only appear on auction listings?
The API documentation lists bids, current_bid and time_left for auctions. The probe listing was a fixed-price item and did not return them, although it did return end_time, so check for each key before reading it.
How are multi-variation listings represented?
According to the API documentation, variations[] contains one entry per dimension, such as size or color, with values[] holding value and out_of_stock. The probe item reported has_variations false in meta, so this structure is documented but not yet observed.
Why are seller feedback values null?
In the observed probe, seller.feedback_pct and seller.feedback_count were null while seller.name was filled in, and category_path and attributes were also null. Treat those fields as nullable and do not use them as a required quality gate.
Can I fetch several listings in one call?
This operation returns one listing per request. For many item IDs at once, the items-batch operation in the same API accepts up to 40 IDs per call.
Which domain should I use?
Use the eBay site the listing belongs to, for example com for ebay.com listings; domain sets the currency and local listing context. The probe used domain com and prices came back in USD.