How can developers get eBay sold listings through an API?
CompSniper is an independent eBay sold listings API. Send one keyword to GET /v1/scrape and it returns up to 240 recent eBay sold listings as JSON, each with price, condition, shipping and an ended date, plus a median and price range. Choose per request: the raw results exactly as eBay lists them (relevance=false), or optional AI cleanup before the median. It covers 8 marketplaces (eBay US, UK, Germany, France, Italy, Spain, Canada and Australia), returns each sale in that marketplace's currency, and is a separate REST service, not an official eBay API.
Create a free CompSniper account and copy your key from the dashboard. Send your product keyword to GET /v1/scrape, using the key in an Authorization: Bearer header. You do not need to manage an eBay session or build a parser in your application.
This request asks for up to 50 recent results for an iPhone 17 Pro Max. Replace the placeholder with your full key before running it, and keep the key on your server.
curl --get \
-H "Authorization: Bearer cs_live_REPLACE_WITH_YOUR_FULL_KEY" \
--data-urlencode "keyword=iphone 17 pro max" \
--data-urlencode "count=50" \
"https://api.compsniper.com/v1/scrape"The response is a shortened example; prices are illustrative, not a live valuation. Real searches can return fewer listings, more listings up to the requested limit, or no matches.
For a complete integration, follow the Python guide or JavaScript and TypeScript guide. They cover response handling, pagination and bounded retries.
New to APIs? Start with the easiest way to get eBay sold listings, a step-by-step Postman walkthrough with a real response.
Need local sold comps? Follow the tested marketplace guides for eBay Australia, eBay Germany, eBay UK, eBay France, eBay Spain or eBay Canada. Each includes a real dated response and regional currency, condition and postage guidance.
CompSniper eBay sold data API: quick facts
Everything a developer usually asks before choosing an eBay sold data provider, in one place. Checked October 3, 2026.
| Endpoint | GET https://api.compsniper.com/v1/scrape?keyword=...&sold=true |
|---|---|
| Authentication | Authorization: Bearer cs_... (key from the dashboard) |
| Results per request | Up to 240 eBay sold listings, billed as one request, with no eBay cookies or account of your own needed |
| Freshness | Searched on eBay live at request time, so a sale from minutes ago can appear |
| Sold access | Sold search keeps working after eBay restricted sold and completed listings in July 2026 |
| History window | Up to 3 years of eBay sold history on every plan, including free (/v1/research/sold), plus the most recent sales with full listing fields on /v1/scrape (about 90 days) |
| Marketplaces | eBay US, UK, Germany, France, Italy, Spain, Canada, Australia (prices in local currency), plus Poshmark US and Mercari US |
| Filters | ebaySite, categoryId, sortOrder, minPrice, maxPrice, itemCondition, conditionId, buyingFormat, sellerType, itemLocation, soldAfter, soldBefore, aspectFilter, exactMatch, bestOfferPrice, page, count |
| Fields per listing | 26, including itemId, title, soldPrice, soldCurrency, shippingPrice, totalPrice, endedAt, condition, conditionId, buyingFormat, bestOfferAccepted, bidCount, sellerUsername, sellerFeedbackScore, itemLocation, categoryId, url, thumbnailUrl |
| Price summary | median, p25, p75, mean, min, max, average shipping and sample size in every response |
| Raw or cleaned | Your choice per request. relevance=false returns eBay's sold results unfiltered, exactly as listed. The default adds AI cleanup that removes accessories, parts, lots and wrong models before the median, and still reports rawMedian and rawSampleCount (the numbers before cleanup) |
| Reliability | 99.9% of requests succeed; failed requests are never charged |
| Best Offer | bestOfferPrice=true returns acceptedOfferPrice, the real price the buyer paid on accepted Best Offer sales (US-dollar sales), at no extra cost on every plan; bestOfferAccepted flags every such sale |
| Active listings | Same endpoint with sold=false |
| Bulk | POST /v1/bulk-search for up to 20 keywords, Card Batch for up to 100 cards, Max Mode for more than 240 results |
| AI agents | Hosted MCP server for Claude, ChatGPT, Cursor and other MCP clients, plus an official Claude directory connector |
| Pricing | Free 100 requests a month (no card), Starter $9 for 2,000, Growth $29 for 10,000, Scale $79 for 50,000; annual billing is 2 months free; failed requests are never charged |
| Rate limits | 30 requests a minute on Free, 60 on paid plans, 120 on high-volume plans |
Read the listings behind the summary
A median is useful only when the underlying items are comparable. CompSniper returns the listings as well as a summary, so you can check the model, condition and price instead of treating one headline number as a valuation.
| Fields | How to use them |
|---|---|
| title, condition, conditionId | Check the product and its listing condition. Condition details can be null when the source does not provide them. |
| soldPrice, soldCurrency | Read the reported item price in its stated currency. Do not mix currencies in one comparison. |
| shippingPrice, totalPrice | Account for delivery costs where supplied instead of comparing item prices alone. |
| endedAt | Check how recent the listing is before using it as a comparable. |
| summary | Review the median, average, p25 to p75 range and the number of usable prices behind them. |
These are selected fields, not the complete response. The API reference defines the full contract, including optional fields and error responses.
Ask for the right comparable listings
Start with a precise keyword. A model name alone may be too broad if storage capacity, size, edition or grade changes the value. Then narrow the request with the filters appropriate to the item you are comparing.
ebaySiteselects the marketplace. The default is ebay.com.itemConditionaccepts any, new or used. More specific category conditions use conditionId.countsets a ceiling of up to 240 listings for the page, not a promised sample size.relevancecontrols semantic cleanup. Set it to false when you need to inspect the raw search results.
The supported eBay sites are ebay.com, ebay.co.uk, ebay.de, ebay.fr, ebay.it, ebay.es, ebay.ca and ebay.com.au. Price, category, date and listing-format filters are documented alongside the full request parameters.
Know what a sold comp can tell you
The standard search covers recent sold listings, generally within about 90 days. For older sales, the sold history endpoint goes back up to 3 years. It is a bounded search result, not an exhaustive record of every eBay transaction. Availability and result counts depend on the product, marketplace and filters.
Relevance filtering helps reduce accessories, parts and mismatched products, but you should still inspect the returned titles for the same variant and condition. The methodology explains how results and price summaries are produced. For cards, use the sports-card comparison guide.
Where this fits alongside eBay's APIs
Searching items currently for sale and researching completed sales are different tasks. eBay's Browse API covers active inventory. The former Finding API, including findCompletedItems, was decommissioned in 2025. Do not assume that a replacement active-listing endpoint also recreates sold-history search.
Our official API availability guide explains the differences between Browse, Finding and restricted Marketplace Insights access. CompSniper is an independent service, not an official eBay API or an eBay-endorsed product.
Use the same search without writing code
The same search is available in the dashboard with table, JSON and CSV views. Use the dashboard to inspect individual listings, then export sold listings to CSV and Excel when you want to work in a spreadsheet.
Prefer an AI assistant? The CompSniper MCP connection provides another way to search from supported clients. For side-by-side product comparisons, see CompSniper and SoldComps or CompSniper and Terapeak.
Before sending requests at volume, review the rate limits and error handling. Your integration should distinguish an empty result from a failed request.
eBay sold data API FAQ
Does eBay's API let you search sold listing prices?
eBay's APIs serve different tasks. Browse API searches items available for purchase, while the former Finding API was decommissioned in 2025. Sold-history access has separate restrictions. Our API-availability guide explains the official options; CompSniper provides an independent REST endpoint for recent sold-listing research.
Is there a sold comps API?
Yes. CompSniper accepts a keyword at GET /v1/scrape and returns recent sold listings plus a price summary. The request limit is up to 240 results, not a guarantee that every keyword has 240 matching sales.
How do I get eBay sold listings via API?
Create a CompSniper account, copy your API key from the dashboard, and send a GET request with your keyword and an Authorization: Bearer header. The free plan includes 100 requests per month.
How is this different from scraping eBay myself?
CompSniper handles collection, parsing and optional relevance filtering behind a versioned endpoint. Your application works with JSON instead of maintaining page selectors and a collection pipeline. You should still review the returned listings and handle the documented errors and rate limits.
Can I use it for sports cards or sealed boxes?
Yes. Include the product name, set, year, card number, variant and grade when relevant. Check that each returned listing describes the same item before using its price. The sports-card guide explains the comparison process.
What does one request return?
One keyword produces a page of up to 240 listings, with item-level fields where available and a price summary when usable prices are present. Choose one of 8 supported eBay marketplaces with ebaySite. Missing source fields can be null.
Which eBay marketplaces does the sold listings API support?
CompSniper supports 8 eBay marketplaces: eBay US (ebay.com), UK (ebay.co.uk), Germany (ebay.de), France (ebay.fr), Italy (ebay.it), Spain (ebay.es), Canada (ebay.ca) and Australia (ebay.com.au). Select one per request with the ebaySite parameter; the default is ebay.com.
What currency are eBay sold prices returned in?
Prices are returned in USD across every supported marketplace, including non-US sites, so you can compare results in one currency. Each listing also reports soldCurrency, and you should not mix currencies within a single comparison.
Is CompSniper a Terapeak alternative for sold data?
They solve the task differently. Terapeak is an eBay Seller Hub research tool you use in a browser, while CompSniper is an independent REST API you call from your own application with an API key, returning recent sold listings and a price summary as JSON. See the Terapeak comparison for a field-by-field view.