# Get the next new product for a keyword — AliExpress Affiliates

Botize method — `aliexpress_associates.search_by_keyword` (trigger).

Returns the next product found 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 a trigger: it starts the task. A task has exactly one.

## 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
- `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.

- `{{product_id}}` *(text)* — Product Id. Product Id
- `{{product_url}}` *(text)* — Product URL. Product detail URL
- `{{affiliate_url}}` *(text)* — Affiliate Product URL. Product detail URL with the user's affiliate code
- `{{image_url}}` *(text)* — Image URL. Main Product image URL
- `{{variants}}` *(array)* — Variants URL
- `{{variants.0}}` *(text)* — Image Variant 1
- `{{variants.1}}` *(text)* — Image Variant 2
- `{{variants.2}}` *(text)* — Image Variant 3
- `{{variants.3}}` *(text)* — Image Variant 4
- `{{variants.4}}` *(text)* — Image Variant 5
- `{{variants.5}}` *(text)* — Image Variant 6
- `{{title}}` *(text)* — Title. Product Title
- `{{target_original_price}}` *(decimal)* — Original Price. Original price in target currency
- `{{target_sale_price}}` *(text)* — Sale Price. Non-App sale price in target currency
- `{{currency}}` *(text)* — Currency. Target Currency
- `{{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.
- `{{category}}` *(text)* — Category. Product category
- `{{subcategory}}` *(text)* — Subcategory. Product subcategory
- `{{rating_percentage}}` *(text)* — Rating percentage. Rating percentage
- `{{recent_sales}}` *(decimal)* — Recent Sales. Recent Sales

## 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/search_by_keyword