Skip to main content
POST
Run AliExpress Product 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-250). Billed at 1 point per returned record.

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

Result page to start from.

Required range: x >= 1
sort
enum<string>
Available options:
best_match,
orders,
price_low_to_high,
price_high_to_low
min_price
number
Required range: x >= 0
max_price
number
Required range: x >= 0
language
enum<string>

AliExpress site language.

Available options:
ar_MA,
de_DE,
en_US,
es_ES,
fr_FR,
in_ID,
it_IT,
iw_IL,
ja_JP,
ko_KR,
nl_NL,
pl_PL,
pt_BR,
ru_RU,
th_TH,
tr_TR,
vi_VN
currency
string

ISO currency code for prices, e.g. USD.

country
string

Ship-to country, ISO 3166 alpha-2.

ship_from
string

Ship-from country, ISO 3166 alpha-2.

free_shipping
boolean
choice
boolean

Only AliExpress Choice items.

four_star_and_up
boolean
local_shipping
boolean

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
min_price
any
max_price
any
currency
any
language
any
country
any
ship_from
any
free_shipping
boolean
choice
boolean
four_star_and_up
boolean
local_shipping
boolean
filters
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.