Search products
search_productsSearch AliExpress for products, prices and alternatives. Returned links are affiliate links.
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": {
"query": "<query>",
"search_terms": "<search_terms>"
},
"name": "search_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results. | |
| query | Yes | Original product request, in any language; used to check relevance. | |
| country | No | Delivery country (ISO 3166-1 alpha-2). Default: client location, else DE. | |
| sort_by | No | relevance | |
| currency | No | Price currency. Default follows the delivery country. | |
| max_price | No | Highest price in the selected currency. | |
| min_price | No | Lowest price in the selected currency. | |
| search_terms | Yes | 3–10 different English search phrases (2–5 words) for the same product: common name, synonyms, seller terms. Keep essential specifications. More phrases find more. | |
| required_title_terms | No | Literal words required in each title or variant options; put semantic requirements in query. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | Suggested next step when the search is incomplete. | |
| items | Yes | ||
| status | No | ||
| country | Yes | Delivery country for these prices; keep it for get_product_details. | |
| currency | Yes |