AliExpress API: Search products (v1)

Search AliExpress products by keyword. Returns 60 products per page with price, rating and sales, in English with USD prices. Use product_id from a result to get the product's details.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

query*string

Search text, matched the way AliExpress's own search box matches it.

Length1 <= length <= 200

page?integer

1-indexed page, 60 products per page, up to page 60. Pages are real pagination, but the order inside a page can shift slightly between calls, so de-duplicate by items[].product_id when collecting several pages.

Range1 <= value <= 60

Default1

sort?string

best_match (AliExpress's default), orders (most sold first), price_asc or price_desc.

Default"best_match"

Value in

"best_match"
"orders"
"price_asc"
"price_desc"

curl -X GET "https://example.com/v1/aliexpress/search?query=phone+case" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "query": "string",    "sort": "string",    "page": 0,    "page_size": 60,    "total_results": 83835,    "has_more": true,    "items": [      {        "product_id": "1005010225936968",        "url": "https://www.aliexpress.com/item/1005010225936968.html",        "title": "Shockproof Soft Liquid Silicone Phone Case For iPhone 17 16 15",        "image": "string",        "price": 1.09,        "price_formatted": "US $1.09",        "original_price": 0,        "discount_percent": 65,        "currency": "USD",        "rating": 4.9,        "sold": "60K+ sold",        "sponsored": true      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}