Endpoint Playground
Returns one page (up to 60 products) of public keyword search results with product ids, titles, links, images, prices, ratings, sold text, discount, SKU id, ship-from country, and store name when AliExpress lists them. Results can be sorted and filtered by price, free shipping, the Choice program, and product attributes; list the attribute values for a keyword with the search-filters endpoint. The search uses the anonymous US English/USD locale. Product-detail pages are currently unavailable through the supported HTTP profiles.
14 Oct 2026: 60 products; 8 fields had a value in every checked item and 5 varied between items.
Sample value profiles: ship_from: CN (51), US (9); price: 0.33 to 2,476.59, median 6.03; sold_text: “10,000+ sold” and 30 other values.
curl 'https://api.crawlora.net/api/v1/aliexpress/search?q=wireless+earbuds&sort=best_match' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | Yes | wireless earbuds | Free-text search keywords |
| page | integer | No | 1-indexed result page (1-60), defaults to 1 | |
| sort | string | No | best_match | Sort order. Allowed values: best_match (default), orders, price_asc, price_desc |
| min_price | number | No | Minimum price in USD (0-1000000) | |
| max_price | number | No | Maximum price in USD (0-1000000), not below min_price | |
| free_shipping | boolean | No | Only free-shipping products | |
| choice | boolean | No | Only products in AliExpress's Choice program | |
| attr | string | No | Attribute filter <attributeId>-<valueId>, from the search-filters endpoint for the same q; comma-separate up to 5 values, one per attribute group | |
| cat_id | integer | No | Search within one AliExpress web category id (the number in a /category/<id>/<slug>.html URL); taxonomy ids from the categories endpoint are a different namespace and are not interchangeable |
{
"code": 200,
"msg": "OK",
"data": {
"query": "wireless earbuds",
"page": 1,
"page_size": 60,
"total_results": 16889,
"total_pages": 60,
"count": 60,
"filters": {
"sort": "best_match"
},
"source_url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds.html?SearchText=wireless+earbuds&catId=0",
"fetched_at": "2026-10-02T00:00:00Z",
"products": [
{
"product_id": "3256812072210872",
"title": "XIAOMI Redmi Airdots 2 Wireless Bluetooth Headset",
"url": "https://www.aliexpress.com/item/3256812072210872.html",
"image_url": "https://ae-pic-a1.aliexpress-media.com/kf/example.jpg",
"price": 2.18,
"currency_code": "USD",
"original_price": 18.33,
"rating": 4.9,
"sold_text": "3,000+ sold",
"discount_percent": 88,
"sku_id": "12000056622341651",
"ship_from": "CN",
"store_name": "Example Store"
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.