ebaysoldlistingsDOCS

Item details

Read the condition, seller notes, item specifics and full description of any eBay listing, sold listings included, with GET /items/details. 1 request per lookup, 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 and the full description. 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.

GET/items/details?itemId=327446760056cost 1 request, free when not found
curl "https://api.ebaysoldlistingsapi.com/items/details?itemId=327446760056" \
  -H "Authorization: Bearer YOUR_API_KEY"
Response (trimmed)
{
  "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"]
}
statusstring

sold, ended (ended without a sale) or active. A won auction is sold; a multi-quantity listing that is still selling is active.

price / currencystring

The sold price (the winning bid for auctions) for sold listings, the current price for active ones.

condition / conditionDescriptionstring | null

eBay's condition label and its definition.

sellerNotesstring | null

What the seller wrote about the condition: wear, defects, missing parts.

itemSpecificsobject

Every item specific on the listing as label to value: brand, model, color, size, card number, grade, grader.

descriptionstring

The seller's description as plain text with line breaks.

soldDate / endDate / startDate, seller, categoryPath, imagesmixed

Dates in ISO 8601, the seller's username, the eBay category path and full-size photo links.

A listing eBay no longer has returns 404 item_unavailable, and a lookup eBay does not answer in time returns 503 server_busy. Neither 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.