Item details
Read the condition, seller notes, item specifics, full description, buying format, bid count and quantity sold of any eBay listing, sold listings included, with GET /items/details or up to 50 at once with POST /items/details/batch. 1 request per listing, never charged when eBay no longer has the listing.
A sold search tells you what sold and for how much. Item details tell you what the seller said about it: the
scratches, the missing charger, the box that was never opened. Pass any itemId from a sold search and get the
listing's condition, the seller's condition notes, every item specific, the full description, the buying format, the
bid count and the quantity available and sold. It works on sold
listings for as long as eBay keeps the listing page, typically months after the sale, and a won auction is reported
as sold at the winning bid.
/items/details?itemId=327446760056cost 1 request, free when not foundcurl "https://api.ebaysoldlistingsapi.com/items/details?itemId=327446760056" \
-H "Authorization: Bearer YOUR_API_KEY"{
"itemId": "327446760056",
"url": "https://www.ebay.com/itm/327446760056",
"title": "SONY WH-1000XM5 wireless noise-canceling over-ear headphones BLACK NIB XMAS HOHO",
"status": "sold",
"soldDate": "2026-11-09T03:59:27.000Z",
"price": "180.00",
"currency": "USD",
"condition": "New",
"sellerNotes": null,
"itemSpecifics": { "Brand": "Sony", "MPN": "WH-1000XM5", "Color": "Black" },
"description": "You are bidding on a SONY WH-1000XM5 wireless noise-canceling over-ear headphones, BLACK BRAND NEW...",
"seller": "losbebes66",
"images": ["https://i.ebayimg.com/images/g/DeUAAeSwxeZq8PEb/s-l1600.webp"],
"buyingFormat": "buyItNow",
"bidCount": null,
"quantityAvailable": 0,
"quantitySold": 1
}statusstringsold, ended (ended without a sale) or active. A won auction is sold; a multi-quantity listing that is still
selling is active.
price / currencystringThe sold price (the winning bid for auctions) for sold listings, the current price for active ones. For a live auction it is the current bid, also when the auction has a Buy It Now price.
condition / conditionDescriptionstring | nulleBay's condition label and its definition.
sellerNotesstring | nullWhat the seller wrote about the condition: wear, defects, missing parts.
itemSpecificsobjectEvery item specific on the listing as label to value: brand, model, color, size, card number, grade, grader.
descriptionstringThe seller's description as plain text with line breaks.
soldDate / endDate / startDate, seller, categoryPath, imagesmixedDates in ISO 8601, the seller's username, the eBay category path and full-size photo links.
buyingFormatstring | nullauction, auctionWithBIN (a live auction that also has a Buy It Now price) or buyItNow (fixed price, with or
without Best Offer). A finished auction is auction.
bidCountinteger | nullNumber of bids on an auction, 0 when nobody has bid yet. null for fixed-price listings.
quantityAvailableinteger | nullUnits a buyer can still purchase: 1 for a single-item active listing, 0 once the listing has ended or sold out.
When eBay shows only "More than 10 available", this is the most one buyer can order from the listing, or null when
eBay hides it.
quantitySoldinteger | nullUnits sold on this listing as eBay shows it (for example 1701 on a multi-quantity listing), 1 for a sold
single-item listing, 0 when nothing has sold.
Batch: up to 50 listings in one job
Send up to 50 item IDs in one request and poll for the results instead of making 50 calls. The batch reads a few listings at a time; 50 listings typically take one to three minutes. Each listing comes back with exactly the same fields as a single lookup.
/items/details/batchcost 1 request per listing returnedcurl -X POST "https://api.ebaysoldlistingsapi.com/items/details/batch" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"itemIds": ["327446760056", "404305439515", "206685403710"]}'GET /items/details/batch/{jobId} returns status (queued, running, complete), the completed, succeeded,
failed and total counts, and results: one entry per listing read so far, in the order you sent the IDs, either
{"itemId", "status": "ok", "details": {...}} or {"itemId", "status": "failed", "code", "error"}.
- Billing: each listing returned is one request, the same as
GET /items/details.item_unavailableand failed listings are never charged. Your remaining requests must cover the batch size when you submit it. - Limits: a batch counts one item details lookup per listing against your per-minute limit when you submit it (the
same limit as
GET /items/details). A batch larger than that limit is refused with400 invalid_params; one that does not fit in the current minute answers429 rate_limitedwithRetry-After. Listings are then read a few at a time, spread over the minute. - Each listing is charged at most once, even when the batch is interrupted (for example by a restart) and resumed.
- One batch job at a time per account (this includes
/scrape/batchjobs); a second one returns409 conflictuntil the first completes.
A listing eBay no longer has returns 404 item_unavailable, a lookup eBay does not answer in time returns
503 server_busy (retry after a few seconds), and a listing whose page loaded but could not be read returns
422 item_unreadable (retrying will not help). None of them is charged. Lookups share your plan's monthly requests and per-minute limit.
Use it to adjust comps by condition, explain a sale far below the median, or read a card's number, grader and grade from item specifics instead of the title.