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

Job accepted; poll Get Session Status with session_id. Once complete, results has the same shape as a synchronous data source response.

session_id
string
run_status
enum<string>
Available options:
running