Skip to main content
POST
Run 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.

max_items
integer
default:25

Maximum number of records to return (1-500). Billed at 1 point per returned record.

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

Result page to start from.

Required range: x >= 1
sort
enum<string>
default:best_match
Available options:
best_match,
ending_soonest,
newly_listed,
price_low,
price_high
condition
enum<string>
Available options:
new,
open_box,
used,
parts
buying_format
enum<string>
Available options:
auction,
buy_it_now
min_price
number
Required range: x >= 0
max_price
number
Required range: x >= 0
category_id
string

eBay category ID (see Run eBay Categories).

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.