Completed / Sold Listings

curl --request GET \
  --url https://scrapebadger.com/v1/ebay/completed \
  --header 'x-api-key: <api-key>'

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))

}

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": "<string>",
      "sold_date_at": "<string>",
      "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>"
}

GET

ebay

completed

Completed / Sold Listings

curl --request GET \
  --url https://scrapebadger.com/v1/ebay/completed \
  --header 'x-api-key: <api-key>'

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))

}

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": "<string>",
      "sold_date_at": "<string>",
      "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 — making it the source of truth for eBay sold-price history and market valuation. Every result has sold set to true on the response envelope.

Query Parameters

string

required

Search keywords. Matches against listing titles.

string

default:"com"

eBay marketplace domain TLD or alias. See /v1/ebay/markets for all supported values.Examples: com, co.uk, de, fr, com.au

string

Restrict results to an eBay category id. Use /v1/ebay/categories to look up ids.

integer

default:1

Page number for paginated results. Range: 1 - 100.

integer

Results per page. Clamped to one of 60, 120, or 240.

string

default:"best_match"

Sort order for results.

Value	Description
`best_match`	Best match (default)
`ending_soonest`	Ended soonest first
`newly_listed`	Most recently ended
`price_low_to_high`	Lowest sold price first
`price_high_to_low`	Highest sold price first

string

Item condition filter (new, open_box, refurbished, used, for_parts).

number

Minimum sold-price filter in the marketplace’s local currency.

number

Maximum sold-price filter in the marketplace’s local currency.

Response

Identical shape to /v1/ebay/search, except sold is true and each result’s price reflects the final sold price.

string

The search query that was executed.

string

Marketplace domain that was searched.

boolean

Always true for completed/sold listings.

array

Array of sold listings (same SearchResult shape as active search).

Show SearchResult object

integer

Position on the page (1-based).

string

eBay listing item id.

string

Listing title.

string

Full URL to the listing.

string

Primary image URL.

object

Final sold price with value, currency, symbol, raw.

string

Item condition label.

string

Buy It Now, Auction, or Best Offer.

boolean

Whether the listing was an auction.

integer

Number of bids the auction received (nullable).

string

Relative time remaining, e.g. 12h 16m (auctions only, nullable).

object

Current high bid for auction listings with value, currency, symbol, raw; mirrors price. Null for non-auction (fixed-price) listings.

string

Shipping text.

string

Item location text.

string

Sale date text as rendered by eBay, e.g. 2 Jul 2026. Localized on non-English marketplaces (e.g. Verkauft 5. Okt. 2024), nullable.

string

Best-effort ISO date parsed from sold_date, e.g. 2026-07-02. Null when the marketplace’s date format is not English.

string

Seller username (nullable).

boolean

Whether the result was a sponsored placement.

object

Available filter facets keyed by name.

object

Pagination metadata with current_page, per_page, total_pages, total_results.

string

ISO 8601 timestamp when the results were scraped.

Example Response

{
  "query": "nintendo switch oled",
  "domain": "com",
  "sold": true,
  "results": [
    {
      "position": 1,
      "item_id": "256987654321",
      "title": "Nintendo Switch OLED Model White - Used",
      "url": "https://www.ebay.com/itm/256987654321",
      "image": "https://i.ebayimg.com/images/g/xyz/s-l500.jpg",
      "price": { "value": 215.5, "currency": "USD", "symbol": "$", "raw": "$215.50" },
      "condition": "Used",
      "buying_format": "Auction",
      "is_auction": true,
      "bids": 14,
      "time_left": null,
      "current_bid": { "value": 215.5, "currency": "USD", "symbol": "$", "raw": "$215.50" },
      "shipping": "Free shipping",
      "location": "United States",
      "sold_date": "18 Jun 2026",
      "sold_date_at": "2026-06-18",
      "seller_name": "gamerdeals99",
      "is_sponsored": false
    }
  ],
  "facets": {},
  "pagination": { "current_page": 1, "per_page": 60, "total_pages": 100, "total_results": 6000 },
  "scraped_at": "2026-06-21T12:00:00Z"
}

Each completed-listings request costs 5 credits. Failed requests are not charged.

Authorizations

x-api-key

string

header

required

Query Parameters

query

string

required

Search keywords.

domain

string

default:com

eBay marketplace domain TLD or alias (com, co.uk, de, fr, ...).

category_id

string

Restrict results to a category id.

page

integer

default:1

Page number for paginated results.

Required range: 1 <= x <= 1000

per_page

integer

Results per page. Clamped to 60, 120 or 240.

Required range: 1 <= x <= 240

sort_by

enum<string>

default:best_match

Sort order for results.

Available options:

best_match,

ending_soonest,

newly_listed,

price_low_to_high,

price_high_to_low

condition

enum<string>

Item condition filter.

Available options:

new,

open_box,

refurbished,

used,

for_parts

min_price

number

Minimum price filter in the marketplace's local currency.

Required range: x >= 0

max_price

number

Maximum price filter in the marketplace's local currency.

Required range: x >= 0

Response

200 - application/json

Completed/sold listings

query

string | null

domain

string

category_id

string | null

sold

boolean

results

object[]

Show child attributes

facets

object

Show child attributes

pagination

object

Show child attributes

scraped_utc

number | null

scraped_at

string | null

Overview

Search

Items

Sellers

Categories

Reference

Completed / Sold Listings

Query Parameters

Response

Example Response

Authorizations

Query Parameters

Response

​Query Parameters

​Response

​Example Response

Authorizations

Query Parameters

Response

Query Parameters

Response

Example Response