Endpoint Playground
Returns AliExpress's own search-box keyword completions for a query, with a ready-to-use search URL for each suggestion. This is a suggestion/autocomplete surface, not a product feed: the upstream payload contains keyword strings only, so no product id, title, price or seller is returned. AliExpress usually offers 10-12 suggestions; each suggestion's url is the matching AliExpress search page and can be passed to the search endpoint as q.
26 Oct 2026: 10 suggestions; 2 fields had a value in every checked item.
Sample value profiles: keyword: “wireless earbuds” and 9 other values; url: aliexpress.com.
curl 'https://api.crawlora.net/api/v1/aliexpress/suggest?q=wireless+earbuds' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | Yes | wireless earbuds | Partial or full search keywords to complete |
| limit | integer | No | Maximum suggestions to return (1-20), defaults to 10 |
{
"code": 200,
"msg": "OK",
"data": {
"query": "wireless earbuds",
"limit": 10,
"count": 3,
"source_url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds.html?SearchText=wireless+earbuds&catId=0",
"fetched_at": "2026-10-25T10:05:33Z",
"suggestions": [
{
"keyword": "wireless earbuds bluetooth",
"url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds-bluetooth.html?SearchText=wireless+earbuds+bluetooth&catId=0"
},
{
"keyword": "wireless earbuds headphones",
"url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds-headphones.html?SearchText=wireless+earbuds+headphones&catId=0"
},
{
"keyword": "wireless earbuds pro",
"url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds-pro.html?SearchText=wireless+earbuds+pro&catId=0"
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.