Skip to main content
POST
eBay item search

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
keyword
string
required

Search term. e.g. wireless mouse

max_items
integer
default:25

Max items (up to 500)

Required range: 1 <= x <= 500
start_page
integer
default:1

Starting page

Required range: x >= 1
sort
enum<string>

Sort by. Options: ending_soonest = Ending soonest, newly_listed = Newly listed, price_low = Price: low to high, price_high = Price: high to low

Available options:
ending_soonest,
newly_listed,
price_low,
price_high
condition
enum<string>

Condition. Options: new = New, open_box = Open box, used = Used, parts = For parts / not working

Available options:
new,
open_box,
used,
parts
buying_format
enum<string>

Buying format. Options: auction = Auction, buy_it_now = Buy It Now

Available options:
auction,
buy_it_now
category_id
string

Category ID. e.g. e.g. 58058

min_price
number

Min price

max_price
number

Max price

Response

Run completed.

session_id
string

Session identifier for this run.

kind
string

Data source identifier for this endpoint.

keyword
string
max_items
integer
start_page
integer
sort
any
condition
any
buying_format
any
min_price
any
max_price
any
category_id
any
partial
boolean

True when the scrape stopped early and returned the records collected so far.

human
string

Markdown summary of the result, for display.

machine
object

Structured result payload.

total_points
integer

Points charged for this run.