# Get 10 products given a keyword — AliExpress Affiliates

Botize method — `aliexpress_associates.get_page_results_by_keyword` (action).

Returns a list of up to 10 products for a specific keyword/s.

- AliExpress returns a single price for each of its products, usually the sale price before applying possible discounts.
- You can select between products from the entire catalog offered by AliExpress or only those from the PLAZA platform (products, stores, shipments and warranty in Spain).
- You can exclude products that share very similar names from the results.
- AliExpress only allows you to enter a keyword in the search, but you can create several tasks and specify a different keyword in each of them.
- You can prioritize the diversity of categories.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `keywords` *(string)* — Search term or keyword
- `exclude_similar_products` *(boolean)* — Exclude products with very similar names
- `filter_same_product_group` *(boolean)* — Increase the diversity of product categories
- `target_language` *(string, one of: "ES" = Spanish - Spain; "MX" = Spanish - Mexico; "CL" = Spanish - Chile; "EN" = English; "IN" = English - India; "FR" = French; "IT" = Italian; "DE" = German; "NL" = Dutch; "RU" = Russian; "PT" = Portuguese; "ID" = Indonesian; "TH" = Thai; "JA" = Japanese; "AR" = Arabic; "VI" = Vietnamese; "TR" = Turkish; "HE" = Hebrew; "KO" = Korean; "PL" = Polish)* — Language
- `min_price` *(string)* — Min. Price (At least one offer price above the specified value)
- `max_price` *(string)* — Max. Price (At least one offer price below the specified value)
- `target_currency` *(string, one of: "EUR" = Euro (EUR); "USD" = US Dollar (USD); "GBP" = British Pound (GBP); "CAD" = Canadian Dollar (CAD); "UAH" = Ukraine Hryvnia (UAH); "MXN" = Mexican Peso (MXN); "TRY" = Turkish Lira (TRY); "RUB" = Russian Rouble (RUB); "BRL" = Brazilian Real (BRL); "AUD" = Australian Dollar (AUD); "INR" = Indian Rupee (INR); "JPY" = Japanese Yen (JPY); "IDR" = Indonesian Rupiah (IDR); "SEK" = Swedish Krona (SEK); "KRW" = South-Korean Won (KRW); "ILS" = Israeli New Shekel (ILS); "THB" = Thai Baht (THB); "CLP" = Chilean Peso (CLP); "VND" = Vietnamese Dong (VND))* — Currency
- `platform_product_type` *(string, one of: "" = All; "PLAZA" = Plaza (Spain local products))* — Platform
- `tracking_id` *(string)* — Tracking Id

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{products}}` *(array)* — Products. List of products
- `{{products.0.product_id}}` *(text)* — Product Id. Product Id
- `{{products.0.product_url}}` *(text)* — Product URL. Product detail URL
- `{{products.0.affiliate_url}}` *(text)* — Affiliate Product URL. Product detail URL with the user's affiliate code
- `{{products.0.image_url}}` *(text)* — Image URL. Main Product image URL
- `{{products.0.title}}` *(text)* — Title. Product Title
- `{{products.0.target_original_price}}` *(decimal)* — Original Price. Original price in target currency
- `{{products.0.target_sale_price}}` *(text)* — Sale Price. Non-App sale price in target currency
- `{{products.0.currency}}` *(text)* — Currency. Target Currency
- `{{products.0.site_price}}` *(text)* — Site Price. Sale price with its currency symbol. Its value is always the same as the 'Sale Price' tag; kept for backwards compatibility with existing tasks.

## Account

Needs a connected AliExpress Affiliates account in Botize: https://botize.com/en/app/aliexpress_associates/authenticate

## This app

Every trigger and action for AliExpress Affiliates: https://botize.com/en/app/aliexpress_associates.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/aliexpress_associates/get_page_results_by_keyword