Skip to main content
GET
/
v1
/
ebay
/
completed
Completed / Sold Listings
curl --request GET \
  --url https://scrapebadger.com/v1/ebay/completed \
  --header 'x-api-key: <api-key>'
{
  "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>",
      "shipping": "<string>",
      "shipping_cost": {
        "value": 123,
        "currency": "<string>",
        "symbol": "<string>",
        "raw": "<string>"
      },
      "free_shipping": true,
      "location": "<string>",
      "returns": "<string>",
      "sold_count": 123,
      "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
  },
  "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

​
query
string
required
Search keywords. Matches against listing titles.
​
domain
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
​
category_id
string
Restrict results to an eBay category id. Use /v1/ebay/categories to look up ids.
​
page
integer
default:1
Page number for paginated results. Range: 1 - 100.
​
per_page
integer
Results per page. Clamped to one of 60, 120, or 240.
​
sort_by
string
default:"best_match"
Sort order for results.
ValueDescription
best_matchBest match (default)
ending_soonestEnded soonest first
newly_listedMost recently ended
price_low_to_highLowest sold price first
price_high_to_lowHighest sold price first
​
condition
string
Item condition filter (new, open_box, refurbished, used, for_parts).
​
min_price
number
Minimum sold-price filter in the marketplace’s local currency.
​
max_price
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.
​
query
string
The search query that was executed.
​
domain
string
Marketplace domain that was searched.
​
sold
boolean
Always true for completed/sold listings.
​
results
array
Array of sold listings (same SearchResult shape as active search).
​
facets
object
Available filter facets keyed by name.
​
pagination
object
Pagination metadata with current_page, per_page, total_pages, total_results.
​
scraped_at
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,
      "shipping": "Free shipping",
      "location": "United States",
      "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 <= 100
​
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[]
​
facets
object
​
pagination
object
​
scraped_utc
number | null
​
scraped_at
string | null