# Get the next new product in a category — Amazon Associates Botize method — `amazon_associates.search_by_category` (trigger). Returns the next product found for a keyword inside a specific category. When using the Amazon API, it's crucial to understand that you can only retrieve results from the first 10 pages, with a maximum of 10 products per page, limiting access to a total of 100 products. To overcome this restriction and access a wider variety of products, it's necessary to make more specific queries. - EU Omnibus regulation (allows to show the lowest price of the last 30 days as a reference price). - You can specify a keyword as well as a category to optimize your search. - Sort the results according to different criteria such as opinions, recent products, top rated , cheap, expensive or relevant. - Improve the quality of the results by setting a minimum number of stars. - Determine with precision the range of products to extract by setting a minimum and maximum price. - Extract the best products by establishing the minimum discount that the products must meet to be selected. - Exclude from the results those products that share very similar names. - Improve the diversity of results by prioritizing 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. - `category` *(string)* — Category - `custom_category` *(string)* - `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 (exclude products with the same subcategories) - `delivery_flags_prime` *(boolean)* — Prioritize Prime products - `delivery_flags_freeshipping` *(boolean)* — Only products eligible for free shipping - `merchant` *(boolean)* — List Offers only from Amazon - `sort` *(string, one of: ""; "AvgCustomerReviews"; "Featured"; "NewestArrivals"; "Price:HighToLow"; "Price:LowToHigh"; "Relevance")* — Sort results - `min_reviews_rating` *(string, one of: ""; "1"; "2"; "3"; "4")* — Filters search results to items with customer review ratings above specified value - `min_saving_percent` *(string, one of: ""; "2"; "5"; "10"; "15"; "20"; "25"; "30"; "40"; "50"; "60"; "70"; "80"; "90")* — At least one offer having saving percentage above the specified value - `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) - `cache_duration_hours` *(string, one of: "24"; "48"; "72"; "96"; "120"; "144"; "168")* — Do not repeat products during the following hours - `language_of_preference` *(string, one of: ""; "fr_BR"; "nl_BE"; "en_GB"; "en_CA"; "fr_CA"; "en_AE"; "ar_AE"; "cs_CZ"; "de_DE"; "nl_NL"; "pl_PL"; "tr_TR"; "en_IN"; "hi_IN"; "kn_IN"; "ml_IN"; "ta_IN"; "te_IN"; "en_US"; "ja_JP"; "zh_CN"; "es_US"; "ko_KR"; "pt_BR"; "zh_TW")* — Languages of preference It also accepts repeatable field groups, with these prefixes: `filter_*`. These are composite components (buttons, filters, keyboards); the trailing number is set by the user as they are added. ## Output variables Data this step makes available. Reference them in later steps with the double-brace tag. - `{{asin}}` *(text)* — ASIN. ASIN stands for Amazon Standard Identification Number. It is a unique identifier of 10 letters or numbers used mainly for the identification of products within the Amazon catalog. - `{{url}}` *(text)* — 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 - `{{features}}` *(text)* — Features. Product Features - `{{condition}}` *(text)* — Product Condition. Product Condition. For example: new - `{{product_group}}` *(text)* — Product Group. Product Category. For example: Video on Demand - `{{price}}` *(decimal)* — Current price. Current price (after saving percentage) in target currency. For example: 22.99 - `{{currency}}` *(text)* — Price:Currency. Target Currency. For example: EUR - `{{display_amount}}` *(text)* — Current price:Formated. Current price (after saving percentage) formated in target currency. For example: 22,99 € - `{{savings_amount}}` *(decimal)* — Saving:Amount. Sales prices in target currency. For example: 17 - `{{savings_currency}}` *(text)* — Saving:Currency. Target Currency. For example: EUR - `{{savings_display_amount}}` *(text)* — Saving:Formated. Sales price formated in target currency. For example: 17,00 € (43%) - `{{savings_display_percentage}}` *(decimal)* — Saving:Percentage. Saving Percentage. For example: 43 - `{{original_price}}` *(decimal)* — Original Price:Amount. Original price, before discounts. For example: 33.99 - `{{display_original_price}}` *(text)* — Original Price:Formated. Original price, before discounts formated in target currency. For example: 33.99 € - `{{is_free_shipping_eligible}}` *(boolean)* — Is free shipping eligible. Specifies whether a product is eligible for free shipping - `{{sold_out}}` *(boolean)* — Sold out. Sold out - `{{is_prime_eligible}}` *(boolean)* — is Prime eligible. Specifies about the prime eligibility about the product. The specific price that a Prime offer could have is not specified because it is not a data provided by Amazon. - `{{savingbasis_amount}}` *(decimal)* — Lowest Recent Price. Strike-Through Pricing and Savings. For example: 55.00 - `{{savingbasis_display_amount}}` *(text)* — Lowest Recent Price:Formated. Strike-Through Pricing and Savings formated in target currency. For example: 55.00 € - `{{savingbasis_label}}` *(text)* — Lowest Recent Price:Label. Label of Strike-Through Pricing and Savings. For example: List price, With deal, Last lowest price, etc - `{{color}}` *(text)* — Color. Indicates the color of the product. For example: red - `{{brand}}` *(text)* — Brand. Brand or manufacturer name of the product. For example: Sony - `{{model}}` *(text)* — Model. Manufacturer's model name or number (e.g., item model number, SKU). For example: WH-1000XM5 - `{{size}}` *(text)* — Size. Provides information related to the size of the item.. For example: XL ## Account Needs a connected Amazon Associates account in Botize: https://botize.com/en/app/amazon_associates/authenticate ## This app Every trigger and action for Amazon Associates: https://botize.com/en/app/amazon_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/amazon_associates/search_by_category