Skip to main content
GET
eBay Search
Beta catalog endpoint. Provider activation and live verification are in progress. An unavailable operation returns HTTP 503 and uses no credits.

Authorizations

x-api-key
string
header
required

Headers

Cache-Control
string
Idempotency-Key
string

Query Parameters

query
string
required
country
enum<string>
Available options:
US,
GB,
AU,
CA,
DE,
FR,
IT,
ES,
IE,
AT,
CH,
NL,
BE,
PL,
SG,
MY,
PH,
HK,
MX
page
integer
Required range: 1 <= x <= 100
sort_by
enum<string>
Available options:
best_match,
price_low,
price_high,
newly_listed,
ending_soonest
condition
enum<string>
Available options:
new,
refurbished,
used
buying_format
enum<string>
Available options:
auction,
buy_it_now,
accepts_offers
show_only
string
min_price
string
max_price
string
aspects
string
cursor
string

Response

Successful response. data is specific to this operation.

success
boolean
required
platform
string
required
endpoint
string
required
credits_used
integer
required
Required range: x >= 0
credits_remaining
integer | null
required
request_id
string
required
cached
boolean
required
data
object
required

Operation-specific data. Fields depend on the endpoint and upstream response; unavailable metrics may be null.