Completed / Sold Listings
curl --request GET \
--url https://scrapebadger.com/v1/ebay/completed \
--header 'x-api-key: <api-key>'import requests
url = "https://scrapebadger.com/v1/ebay/completed"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://scrapebadger.com/v1/ebay/completed', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrapebadger.com/v1/ebay/completed",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://scrapebadger.com/v1/ebay/completed"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/ebay/completed")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://scrapebadger.com/v1/ebay/completed")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"query": "<string>",
"domain": "<string>",
"category_id": "<string>",
"sold": true,
"results": [
{
"position": 123,
"item_id": "<string>",
"product_id": "<string>",
"title": "<string>",
"url": "<string>",
"image": "<string>",
"price": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"original_price": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"discount_percent": 123,
"currency": "<string>",
"condition": "<string>",
"brand": "<string>",
"buying_format": "<string>",
"is_auction": true,
"bids": 123,
"time_left": "<string>",
"current_bid": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"shipping": "<string>",
"shipping_cost": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"free_shipping": true,
"location": "<string>",
"returns": "<string>",
"sold_count": 123,
"sold_date": "2 Jul 2026",
"sold_date_at": "2026-07-02",
"ended_at": "2026-07-02T14:31:00Z",
"watchers": 123,
"coupon": "<string>",
"rating": 123,
"ratings_total": 123,
"seller_name": "<string>",
"seller_feedback_percent": 123,
"seller_feedback_score": 123,
"program_badge": "<string>",
"is_sponsored": true
}
],
"facets": {},
"pagination": {
"current_page": 123,
"per_page": 123,
"total_pages": 123,
"total_results": 123,
"has_more": true
},
"scraped_utc": 123,
"scraped_at": "<string>"
}Search
Completed / Sold Listings
Search eBay completed (sold) listings — the closing prices buyers actually paid.
GET
/
v1
/
ebay
/
completed
Completed / Sold Listings
curl --request GET \
--url https://scrapebadger.com/v1/ebay/completed \
--header 'x-api-key: <api-key>'import requests
url = "https://scrapebadger.com/v1/ebay/completed"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://scrapebadger.com/v1/ebay/completed', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrapebadger.com/v1/ebay/completed",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://scrapebadger.com/v1/ebay/completed"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/ebay/completed")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://scrapebadger.com/v1/ebay/completed")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"query": "<string>",
"domain": "<string>",
"category_id": "<string>",
"sold": true,
"results": [
{
"position": 123,
"item_id": "<string>",
"product_id": "<string>",
"title": "<string>",
"url": "<string>",
"image": "<string>",
"price": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"original_price": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"discount_percent": 123,
"currency": "<string>",
"condition": "<string>",
"brand": "<string>",
"buying_format": "<string>",
"is_auction": true,
"bids": 123,
"time_left": "<string>",
"current_bid": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"shipping": "<string>",
"shipping_cost": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"free_shipping": true,
"location": "<string>",
"returns": "<string>",
"sold_count": 123,
"sold_date": "2 Jul 2026",
"sold_date_at": "2026-07-02",
"ended_at": "2026-07-02T14:31:00Z",
"watchers": 123,
"coupon": "<string>",
"rating": 123,
"ratings_total": 123,
"seller_name": "<string>",
"seller_feedback_percent": 123,
"seller_feedback_score": 123,
"program_badge": "<string>",
"is_sponsored": true
}
],
"facets": {},
"pagination": {
"current_page": 123,
"per_page": 123,
"total_pages": 123,
"total_results": 123,
"has_more": true
},
"scraped_utc": 123,
"scraped_at": "<string>"
}The completed-listings endpoint returns sold items — the closing prices buyers
actually paid, with the date each item sold. Every result has
Every result is one of that seller’s sales, and
Pages stop at
sold set to true
on the response envelope. This is the data resellers, flippers and pricing tools
rely on, since asking prices alone don’t reflect what items actually sell for.
Search by keywords, by seller, or both. With seller and no query you get
everything that seller sold.
Query Parameters
Search keywords. Matches against listing titles. Optional when
seller is
set; send at least one of the two.Only this seller’s sold listings, by eBay username (e.g.
musicmagpie). Works
on its own, with no keyword, and combines with query and every other filter.eBay marketplace domain TLD or alias. See
/v1/ebay/markets for all supported values.Examples: com, co.uk, de, fr, com.auRestrict results to an eBay category id. Use
/v1/ebay/categories to look up ids.Page number for paginated results. Range:
1 - 100.Use pagination.has_more to know when to stop — eBay re-serves its last
page if you ask past the end, so this API returns an empty page there.Results per page. Clamped to one of
60, 120, or 240. eBay puts at most
200 sold listings on a page, so 240 returns 200 and pagination.per_page
says 200; pagination.returned says how many this page holds.Sort order for results. On sold listings eBay applies only the price sorts.
| Value | Description |
|---|---|
best_match | Newest ended_at first (default) |
ending_soonest | Same order as best_match: eBay ignores it on sold listings |
newly_listed | Same order as best_match: eBay ignores it on sold listings |
price_low_to_high | Lowest sold price first |
price_high_to_low | Highest sold price first |
Item condition filter (
new, open_box, refurbished, used, for_parts).Trading cards also accept graded and ungraded — eBay’s card conditions for
slabbed (PSA / BGS / CGC) versus raw cards. Pricing a raw card against sales
that include slabs skews the average badly, so price the two separately.Item location.
Omit it and you get eBay’s default, which mixes foreign listings into a national
marketplace. Two things follow from that, and both matter for price research:
a national price series picks up sales that never happened in that country, and
a foreign listing’s price is shown converted into the marketplace’s currency
rather than the amount it actually sold for.
| Value | Description |
|---|---|
domestic | Only items located in this marketplace’s own country (domain=fr → France only) |
worldwide | Items from every country |
location=domestic removes both.Any other value returns 400 invalid_location — it is never silently ignored.Response
Identical shape to/v1/ebay/search, except sold is true, each result’s price reflects the final sold price, and each result carries a sold_date.
Array of sold listings (same
SearchResult shape as active search).Show SearchResult object
Show SearchResult object
Final sold price with
value, currency, symbol, raw. For a listing that sold through an accepted Best Offer, eBay’s sold index carries the listed price; Get Item Detail returns the accepted amount.Winning bid for auction listings with
value, currency, symbol, raw; mirrors price. Null for fixed-price listings.Sale date text as rendered by eBay, e.g.
Aug 19, 2026. Localized on non-English marketplaces (e.g. Verkauft 5. Okt. 2024), nullable.ISO date of eBay’s “Sold” label, e.g.
2026-08-19: a day the item sold, on the marketplace’s calendar. On a multi-quantity listing eBay labels an earlier sale, months before ended_at at times. On non-English marketplaces it is the day ended_at falls on in Europe/Berlin.When eBay last closed this listing out, in UTC to the minute, e.g.
2026-08-19T14:31:00Z: the listing’s end, or the latest sale on a multi-quantity listing that is still live. Results are ordered by it, newest first.Pagination metadata with
current_page, per_page, total_results, has_more.total_results is populated (the sold results page carries a match count). total_pages may be null — page with has_more rather than a fixed page total.Example Response
{
"query": "nintendo switch",
"domain": "com",
"sold": true,
"results": [
{
"position": 1,
"item_id": "256987654321",
"title": "Nintendo Switch (OLED Model) - Used",
"url": "https://www.ebay.com/itm/256987654321",
"image": "https://i.ebayimg.com/images/g/xyz/s-l500.jpg",
"price": { "value": 260.0, "currency": "USD", "symbol": "$", "raw": "$260.00" },
"condition": "Pre-Owned",
"buying_format": "Auction",
"is_auction": true,
"bids": 14,
"current_bid": { "value": 260.0, "currency": "USD", "symbol": "$", "raw": "$260.00" },
"shipping": "Free shipping",
"location": "United States",
"sold_date": "Aug 19, 2026",
"sold_date_at": "2026-08-19",
"ended_at": "2026-08-19T14:31:00Z",
"seller_name": "gamerdeals99",
"is_sponsored": null
}
],
"facets": {},
"pagination": { "current_page": 1, "per_page": 60, "total_pages": null, "total_results": 34000, "has_more": true },
"scraped_at": "2026-08-20T12:00:00Z"
}
Sold listings for one seller
Passseller without a query to page through everything one seller sold:
curl --get 'https://scrapebadger.com/v1/ebay/completed' \
--data-urlencode 'seller=musicmagpie' \
--data-urlencode 'domain=co.uk' \
--data-urlencode 'per_page=200' \
--header 'x-api-key: YOUR_API_KEY'
seller_name says so. Add
query, category_id, condition or a price range to narrow it down. eBay
handles the request; no eBay account or cookies are needed on your side. How
far back it reaches is eBay’s own sold history for that marketplace.
Fetching every sold listing
has_more is the stop signal for bulk extraction. Increment page while it is true:
page, all_sold = 1, []
while True:
r = requests.get(
"https://scrapebadger.com/v1/ebay/completed",
params={"query": "iphone 13", "per_page": 200, "page": page},
headers={"X-API-Key": API_KEY},
).json()
all_sold += r["results"]
if not r["results"] or not r["pagination"]["has_more"]:
break
page += 1
Do not loop on “until the response is empty” alone. Past its last page eBay
clamps — asking for page 200 of a 133-page result set re-serves page 133.
This API detects that and returns an empty page with
has_more: false, but a
client that ignores has_more and retries forever will keep spending credits.100, so one search returns at most 20,000 listings at per_page=200; narrow a bigger result set with condition, category_id or a price range (min_price / max_price).
Use the largest per_page you can: each request costs 8 credits regardless of page
size, so per_page=200 is about 3x cheaper per listing than the default.
Collecting one day’s sales
Results come newestended_at first, so one day of a seller’s sales is a run of
consecutive pages. To collect a calendar day in your timezone:
- Convert the day’s start and end to UTC (for
Europe/Londonon 1 November,2026-11-01T00:00:00Zto2026-11-02T00:00:00Z). - Walk
seller=<username>&per_page=200&page=1,2,…, keeping results whoseended_atfalls inside that window. - Stop at the first page whose last result has
ended_atbefore the window’s start. - De-duplicate on
item_id.
- One result per listing, not per sale. A multi-quantity listing that sold several units appears once, at its latest sale. If it sells again after your day, it moves to that later time, so walk soon after the day ends.
- eBay’s sold index is not perfectly consistent. The same page can come back
slightly different from one call to the next (one seller’s page 1 came back in
three versions, 217 listings between them, 200 each). A second walk later can
return a few listings the first missed. Merge walks on
item_id. - The sold history is eBay’s. It covers roughly the last 90 days.
/v1 call, so space a long walk out; a 429 carries a Retry-After
header with the seconds to wait.
Each completed/sold request costs 8 credits. Failed requests are not charged.
Query Parameters
Item location. domestic returns only items located in this marketplace's own country (domain=fr → France only); worldwide widens to every country. Foreign listings are priced in the marketplace's currency after eBay CONVERTS them, so domestic is also how you get untouched native sale prices.
Available options:
domestic, worldwide 
