ebaysoldlistingsDOCS

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.

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"],
  "buyingFormat": "buyItNow",
  "bidCount": null,
  "quantityAvailable": 0,
  "quantitySold": 1
}
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. For a live auction it is the current bid, also when the auction has a Buy It Now price.

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.

buyingFormatstring | null

auction, 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 | null

Number of bids on an auction, 0 when nobody has bid yet. null for fixed-price listings.

quantityAvailableinteger | null

Units 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 | null

Units 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.

POST/items/details/batchcost 1 request per listing returned
curl -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_unavailable and 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 with 400 invalid_params; one that does not fit in the current minute answers 429 rate_limited with Retry-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/batch jobs); a second one returns 409 conflict until 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.

On this page