Skip to main content
POST
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. e.g. wireless mouse

max_items
integer
default:25

Max items (up to 250)

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

Starting page

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

Sort by. Options: orders = Orders, price_low_to_high = Price: low to high, price_high_to_low = Price: high to low

Available options:
orders,
price_low_to_high,
price_high_to_low
currency
enum<string>

Currency. Options: USD = USD, EUR = EUR, GBP = GBP, CAD = CAD, AUD = AUD, RUB = RUB, BRL = BRL, CLP = CLP, JPY = JPY, KRW = KRW, CHF = CHF, SEK = SEK, PLN = PLN, ILS = ILS, NOK = NOK, DKK = DKK, NZD = NZD, MXN = MXN, COP = COP, TRY = TRY, THB = THB, SGD = SGD, MYR = MYR, PHP = PHP, IDR = IDR, INR = INR, VND = VND, HKD = HKD, TWD = TWD, AED = AED, SAR = SAR, CZK = CZK, HUF = HUF, RON = RON, BGN = BGN, UAH = UAH, KZT = KZT, ARS = ARS, EGP = EGP, ZAR = ZAR, CNY = CNY, PEN = PEN

Available options:
USD,
EUR,
GBP,
CAD,
AUD,
RUB,
BRL,
CLP,
JPY,
KRW,
CHF,
SEK,
PLN,
ILS,
NOK,
DKK,
NZD,
MXN,
COP,
TRY,
THB,
SGD,
MYR,
PHP,
IDR,
INR,
VND,
HKD,
TWD,
AED,
SAR,
CZK,
HUF,
RON,
BGN,
UAH,
KZT,
ARS,
EGP,
ZAR,
CNY,
PEN
min_price
number

Min price

max_price
number

Max price

language
enum<string>

Content language. Options: ar_MA = ar_MA, de_DE = de_DE, en_US = en_US, es_ES = es_ES, fr_FR = fr_FR, in_ID = in_ID, it_IT = it_IT, iw_IL = iw_IL, ja_JP = ja_JP, ko_KR = ko_KR, nl_NL = nl_NL, pl_PL = pl_PL, pt_BR = pt_BR, ru_RU = ru_RU, th_TH = th_TH, tr_TR = tr_TR, vi_VN = vi_VN

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
country
string

Ship-to country. e.g. US

ship_from
string

Ship-from country. e.g. Any

filters
string

Attribute filters. e.g. Comma-separated

free_shipping
boolean

Free shipping

choice
boolean

AliExpress Choice

four_star_and_up
boolean

4 stars & up

local_shipping
boolean

Local shipping

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.