Skip to main content
GET
Search Listings

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 - 1000.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.
integer
Results per page. Clamped to one of 60, 120, or 240.
string
default:"best_match"
Sort order for results.
string
Item condition filter.graded / ungraded are eBay’s card-specific conditions. Pricing a raw card against sales that include slabs skews the average badly — price the two separately.
string
Buying format filter.
number
Minimum price filter in the marketplace’s local currency.
number
Maximum price filter in the marketplace’s local currency.
boolean
default:false
Only return listings with free shipping.
string
Item location.Omit it and you get eBay’s default, which mixes foreign listings into a national marketplace. Two things follow, 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. location=domestic removes both.

Response

string
The search query that was executed.
string
Marketplace domain that was searched.
string
The category id filter applied (nullable).
boolean
Always false for active-listing search (see /completed for sold).
array
Array of matching listings.
object
Available filter facets keyed by name, each a list of string values.
object
Pagination metadata with current_page, per_page, total_pages, total_results.
string
ISO 8601 timestamp when the results were scraped.

Example Response

Each search 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. graded / ungraded are eBay's trading-card conditions — slabbed (PSA/BGS/CGC) vs raw — so a card can be priced separately from its slabs.

Available options:
new,
open_box,
refurbished,
used,
for_parts,
graded,
ungraded
buying_format
enum<string>

Buying format filter.

Available options:
auction,
buy_it_now,
best_offer
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
free_shipping
boolean
default:false

Only return listings with free shipping.

location
enum<string>

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

Response

200 - application/json

Active 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