aliexpress_search
Search AliExpress products by keyword and apply price, free-shipping, Choice, category, attribute, and sort filters to return product IDs, titles, links, images, prices, ratings, and store details.
Instructions
Search AliExpress products. 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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"q": "<q>"
},
"name": "aliexpress_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Free-text search keywords | |
| attr | No | Attribute filter <attributeId>-<valueId>, from the search-filters endpoint for the same q; comma-separate up to 5 values, one per attribute group | |
| page | No | 1-indexed result page (1-60), defaults to 1 | |
| sort | No | Sort order. Allowed values: best_match (default), orders, price_asc, price_desc | |
| cat_id | 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 | |
| choice | No | Only products in AliExpress's Choice program | |
| max_price | No | Maximum price in USD (0-1000000), not below min_price | |
| min_price | No | Minimum price in USD (0-1000000) | |
| free_shipping | No | Only free-shipping products |