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

Lookup by item ID or pasted URL Send item_id for a known listing number or paste the full listing url; either one identifies the listing, so user-supplied links work without parsing the ID yourself.
Product identity and item specifics Returns brand, model, mpn and an item_specifics object (22 entries in the probe, such as Color, RAM, Screen Size and Network) for matching listings to your own catalog.
Price, list price and stock signals price and list_price (274.99 against 899 in the probe) sit beside availability, quantity_available, quantity_sold, watchers and best_offer, giving demand and discount context in one record.
Shipping and return terms shipping reports country, currency and rate, and return_policy reports the return window in days and the return method, so seller terms can be compared across listings.
Auction and variation fields According to the API documentation, auction listings add bids, current_bid and time_left, and multi-variation listings add variations[] with an out_of_stock flag per value; the probe listing had neither, so handle them as optional.
Optional full seller description Set include_description to true to inline the seller's description text for compliance or keyword checks; it costs one extra request and stays off by default, with description_url returned either way in the probe.

Live API Demo

POST /api/project/ebay/item-detail

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X POST 'https://api.opendata-api.com/api/project/ebay/item-detail?key=<API_KEY>'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →