eBay Marketplace Insights API Alternative (2026), Unlimited Plan
The practical eBay Marketplace Insights API alternative in 2026 is a sold-listings API that works without eBay's approval: the eBay Sold Listings API returns up to 240 completed eBay sales per request as JSON or CSV, acr
The practical eBay Marketplace Insights API alternative in 2026 is a sold-listings API that works without eBay's approval: the eBay Sold Listings API returns up to 240 completed eBay sales per request as JSON or CSV, across 8 eBay marketplaces, with a free key you create in a minute and an Unlimited plan when your volume grows. Marketplace Insights itself is a limited release, so if you were not let in, you can map its item_sales/search fields to this API and keep your code almost unchanged.
Last checked: November 2026.
I'm James from the eBay Sold Listings API team. Most of the developers who write to us arrive the same way: they designed a pricing feature around Marketplace Insights, applied, and then waited. This post is the migration I would want in that situation.
Why developers look for a Marketplace Insights alternative
Marketplace Insights is eBay's only first-party API for sold items. Its item_sales/search method returns items sold in the last 90 days. The catch is access. It sits in eBay's Buy API family, which eBay describes as limited release and intended for eBay partners, and eBay states plainly that there is no guarantee an application will be approved.
That leaves three dead ends for most people:
| eBay option | Sold items? | Can you use it today? |
|---|---|---|
Marketplace Insights item_sales/search
|
Yes, last 90 days | Only with eBay approval |
Browse API item_summary/search
|
No, active listings only | Yes |
Finding API findCompletedItems
|
Used to | No, retired in February 2025 |
eBay Sold Listings API GET /scrape
|
Yes, up to 240 per call | Yes, free key, no approval |
If you want the full story on applying, I wrote it up separately in "How to Get eBay Marketplace Insights API Access in 2026" (link: post 02).
The equivalent request
Here is the whole thing in cURL. Sold results are the default, so there is no "sold only" flag to set:
curl "https://api.ebaysoldlistingsapi.com/scrape?keyword=nintendo+switch+oled&ebaySite=ebay.com&count=240" \
-H "Authorization: Bearer YOUR_API_KEY"
The response is an envelope with paging info and a results array:
{
"keyword": "nintendo switch oled",
"ebaySite": "ebay.com",
"count": 240,
"page": 1,
"hasNextPage": true,
"totalResults": 2900,
"results": [
{
"itemId": "1256xxxxxxxx",
"title": "Nintendo Switch OLED White",
"soldPrice": "255.00",
"soldCurrency": "USD",
"endedAt": "2026-09-20",
"condition": "Pre-Owned",
"buyingFormat": "buyItNow",
"bestOfferAccepted": false,
"shippingPrice": "0",
"totalPrice": "255.00",
"sellerUsername": "top_deals_88",
"url": "https://www.ebay.com/itm/1256xxxxxxxx"
}
]
}
Field mapping: Marketplace Insights to the Sold Listings API
| Marketplace Insights | eBay Sold Listings API |
|---|---|
itemSales[] |
results[] |
itemId |
itemId |
title |
title |
lastSoldPrice.value / .currency
|
soldPrice / soldCurrency
|
lastSoldDate |
endedAt (a YYYY-MM-DD date) |
condition |
condition |
itemWebUrl |
url |
image.imageUrl |
thumbnailUrl |
seller.username |
sellerUsername |
buyingOptions |
buyingFormat (auction or buyItNow) |
q |
keyword |
category_ids |
categoryId (one numeric id) |
X-EBAY-C-MARKETPLACE-ID header |
ebaySite parameter |
| (no equivalent) |
shippingPrice, totalPrice, bestOfferAccepted, bidCount
|
The last row matters for pricing. totalPrice is the sale price plus shipping, which is what the buyer really spent, and bestOfferAccepted tells you when the listed price was not the price paid.
A drop-in adapter in Python
If your app already consumes Marketplace Insights shaped data, you do not need to rewrite it. Wrap the new API in a function that returns the old shape, and swap the import.
import os
import requests
API = "https://api.ebaysoldlistingsapi.com/scrape"
KEY = os.environ["EBAY_SOLD_API_KEY"] # starts with eb_
# Marketplace Insights marketplace ids -> ebaySite values
SITES = {
"EBAY_US": "ebay.com", "EBAY_GB": "ebay.co.uk", "EBAY_DE": "ebay.de",
"EBAY_AU": "ebay.com.au", "EBAY_CA": "ebay.ca", "EBAY_FR": "ebay.fr",
"EBAY_IT": "ebay.it", "EBAY_ES": "ebay.es",
}
FORMATS = {"auction": "AUCTION", "buyItNow": "FIXED_PRICE"}
def item_sales_search(q, marketplace_id="EBAY_US", category_ids=None, page=1):
params = {"keyword": q, "ebaySite": SITES[marketplace_id], "count": 240, "page": page}
if category_ids:
params["categoryId"] = category_ids
r = requests.get(API, params=params,
headers={"Authorization": f"Bearer {KEY}"}, timeout=90)
r.raise_for_status()
data = r.json()
return {
"total": data["totalResults"],
"hasNextPage": data["hasNextPage"],
"itemSales": [
{
"itemId": s["itemId"],
"title": s["title"],
"lastSoldPrice": {"value": s["soldPrice"], "currency": s["soldCurrency"]},
"lastSoldDate": s["endedAt"],
"condition": s["condition"],
"itemWebUrl": s["url"],
"image": {"imageUrl": s.get("thumbnailUrl")},
"seller": {"username": s.get("sellerUsername")},
"buyingOptions": [FORMATS.get(s.get("buyingFormat"), "FIXED_PRICE")],
# extras Marketplace Insights never gave you
"totalPrice": s.get("totalPrice"),
"bestOfferAccepted": s.get("bestOfferAccepted"),
}
for s in data["results"]
],
}
if __name__ == "__main__":
out = item_sales_search("gopro hero 12", "EBAY_GB")
for sale in out["itemSales"][:5]:
print(sale["lastSoldDate"], sale["lastSoldPrice"], sale["title"])
Two details to watch while migrating:
-
Dates.
lastSoldDatewas a full timestamp;endedAtis a date. If you sort or bucket by day, nothing changes. If you compared times within a day, adjust that code. - Currency. Each marketplace answers in its own currency (GBP for ebay.co.uk, EUR for ebay.de, and so on). Nothing is converted for you, which is usually what you want for comps.
Filters that carry over
- Price band:
minPriceandmaxPrice, in the marketplace currency. - Condition:
itemCondition=neworused, or an exact eBayconditionId. - Format:
buyingFormat=auction,buyItNoworacceptsOffers. - Date window:
soldAfterandsoldBeforeasYYYY-MM-DD. - Sort:
sortOrder=endedRecently,pricePlusPostageLowest,pricePlusPostageHighest. - Paging:
pagefrom 1 to 100 whilehasNextPageis true.
One habit from Marketplace Insights does not carry over well: long queries. eBay matches every word you send, so a full listing title often returns very little. Start with brand plus model, or card name plus set and number.
What you get that Marketplace Insights did not offer
-
The real Best Offer price. Add
bestOfferPrice=trueand every sale withbestOfferAccepted: truealso carriesacceptedOfferPriceandacceptedOfferPriceStatus(found,pendingornot_available). Same single request, no extra cost. -
Active listings from the same endpoint with
sold=false, so the asking side of the market uses the same parser. -
CSV on any search with
format=csv. -
Batch jobs of up to 100 keywords with
POST /scrape/batch, downloadable as one CSV. - 8 marketplaces: ebay.com, ebay.co.uk, ebay.de, ebay.com.au, ebay.ca, ebay.fr, ebay.it, ebay.es.
Built for volume: the Unlimited plan
Marketplace Insights was meant for apps that price a lot of items, so request quotas matter. The Unlimited plan has no monthly request cap. A repricer, a valuation app or a nightly catalogue refresh can run on it without buying requests in blocks or watching an allowance. Batch jobs (up to 100 keywords per job, one CSV download) make large refreshes simple to schedule, and only successful requests count; errors are never billed. Details are on ebaysoldlistingsapi.com. If you are sizing a big workload, Unlimited eBay Sold Data API (2026) shows how to count it yourself.
FAQ
Is there an official way to get eBay sold items without Marketplace Insights?
Not from eBay today. The Browse API returns active listings only and the Finding API's findCompletedItems was retired in February 2025. A third-party sold-listings API is the route that does not need approval.
How long does it take to switch?
For most apps, an afternoon. The adapter above keeps your Marketplace Insights shaped objects, so the rest of your code does not move.
Does it cover more than the US?
Yes. Pass ebaySite for any of the 8 supported eBay sites. Prices come back in that site's local currency.
Can I keep Marketplace Insights if I get approved later?
Yes. Keep the adapter interface and point it at whichever source you prefer. Many teams run a sold-listings API for the extras (Best Offer prices, CSV, batch) either way.
Is there an unlimited plan for high volume?
Yes. The Unlimited plan has no monthly request cap. You can start free and move up from the dashboard when your volume needs it; your key and code stay the same.
What does a failed request cost?
Nothing. Every error response, including 5xx, is free. Retry 429, 502, 503 and 504 with backoff and a 90 second client timeout.
Try it
Create a free key (no card needed) at ebaysoldlistingsapi.com, run the cURL above, and paste the adapter into your project. The full field list is in the response docs.
Originally published by Dev.to WebDev. Aggregated on AIWithGhost for educational purposes — full credit and traffic to the original publisher.