---
title: "Completed / Sold Listings"
method: GET
path: "/v1/ebay/completed"
tags: ["eBay Search"]
---

# Completed / Sold Listings

`GET /v1/ebay/completed`

Search completed/sold listings - eBay's real sold-price history.

## Query parameters

- `query` string, required
- `domain` string
- `category_id` string
- `page` integer
- `per_page` integer
- `sort_by` 'best_match' | 'ending_soonest' | 'newly_listed' | 'price_low_to_high' | 'price_high_to_low'
- `condition` 'new' | 'open_box' | 'refurbished' | 'used' | 'for_parts'
- `min_price` number
- `max_price` number

## Response `200`

Completed/sold listings

- object
  - `query` string, nullable
  - `domain` string
  - `category_id` string, nullable
  - `sold` boolean
  - `results` object[]
    - `position` integer
    - `item_id` string, nullable
    - `product_id` string, nullable
    - `title` string, nullable
    - `url` string, nullable
    - `image` string, nullable
    - `price` object
      - `value` number, nullable
      - `currency` string, nullable
      - `symbol` string, nullable
      - `raw` string, nullable
    - `original_price` object
      - `value` number, nullable
      - `currency` string, nullable
      - `symbol` string, nullable
      - `raw` string, nullable
    - `discount_percent` number, nullable
    - `currency` string, nullable
    - `condition` string, nullable
    - `brand` string, nullable
    - `buying_format` string, nullable
    - `is_auction` boolean
    - `bids` integer, nullable
    - `time_left` string, nullable
    - `current_bid` object, nullable — Current high bid for auction listings; mirrors `price`. Null for non-auction (fixed-price) listings.
      - `value` number, nullable
      - `currency` string, nullable
      - `symbol` string, nullable
      - `raw` string, nullable
    - `shipping` string, nullable
    - `shipping_cost` object
      - `value` number, nullable
      - `currency` string, nullable
      - `symbol` string, nullable
      - `raw` string, nullable
    - `free_shipping` boolean, nullable
    - `location` string, nullable
    - `returns` string, nullable
    - `sold_count` integer, nullable
    - `sold_date` string, nullable — Sale date text as rendered by eBay on the sold card, e.g. "2 Jul 2026". Localized on non-English marketplaces (e.g. "Verkauft 5. Okt. 2024"). Null on active listings.
    - `sold_date_at` string, nullable — Best-effort ISO 8601 date parsed from sold_date, e.g. "2026-07-02". Null when the marketplace's date format is not English.
    - `watchers` integer, nullable
    - `coupon` string, nullable
    - `rating` number, nullable
    - `ratings_total` integer, nullable
    - `seller_name` string, nullable
    - `seller_feedback_percent` number, nullable
    - `seller_feedback_score` integer, nullable
    - `program_badge` string, nullable
    - `is_sponsored` boolean
  - `facets` object
  - `pagination` object
    - `current_page` integer
    - `per_page` integer, nullable
    - `total_pages` integer, nullable
    - `total_results` integer, nullable
  - `scraped_utc` number, nullable
  - `scraped_at` string, nullable

---

[API](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api.md) · [All operations](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrapebadger/scrapebadger-account-api/revisions/4a1ef8777baf/schema)