# Obtener un grupo de productos dada una palabra clave — Amazon Afiliados

Método de Botize — `amazon_associates.get_page_results_by_keyword` (acción).

Extrae una lista de hasta 10 productos para una palabra ('Cafeteras') o palabra compuesta ('Harry Potter').

Al usar la API de Amazon, es crucial entender que sólo se pueden obtener los resultados de las primeras 10 páginas, con un máximo de 10 productos por página, limitando el acceso a un total de 100 productos. Para superar esta restricción y acceder a una variedad más amplia de productos, es necesario realizar consultas más específicas.

- Normativa UE Omnibus (permite mostrar el precio más bajo de los últimos 30 días como precio de referencia).
- Ordena los resultados de acuerdo a distintos criterios tales como opiniones, productos recientes, más valorados, económicos, caros o relevantes.
- Mejora la calidad de los resultados estableciendo un número mínimo de estrellas.
- Determina con precisión el rango de productos a extraer estableciendo un precio mínimo y máximo.
- Extrae los mejores productos estableciendo el descuento mínimo que deben cumplir los productos para ser seleccionados.
- Excluye de los resultados aquellos productos que compartan nombres muy similares.
- Mejora la diversidad de resultados priorizando la diversidad de categorías.

Es una acción: ocurre como paso de una tarea. Se pueden encadenar varias.

## Campos que se configuran

Nombre interno del campo, tipo y valores admitidos. En estos campos se pueden insertar etiquetas `{{...}}` de pasos anteriores.

- `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
- `delivery_flags_prime` *(boolean)* — Only products eligible for Prime
- `delivery_flags_freeshipping` *(boolean)* — Only products eligible for free shipping
- `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"; "custom")* — At least one offer having saving percentage above the specified value
- `custom_min_saving_percent` *(string)* — Custom saving percentage
- `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)
- `max_products` *(string, one of: "10"; "9"; "8"; "7"; "6"; "5"; "4"; "3"; "2")* — Maximum number of products to extract

Además admite grupos de campos repetibles, con estos prefijos: `filter_*`. Son componentes compuestos (botones, filtros, teclados); el número final lo pone el usuario al añadirlos.

## Variables de salida

Datos que este paso deja disponibles. Se referencian en pasos posteriores con la etiqueta entre dobles llaves.

- `{{products}}` *(array)* — Productos. Lista de productos
- `{{products.0.asin}}` *(text)* — ASIN. ASIN son las siglas de Amazon Standard Identification Number.
Es un identificador único de 10 letras o números utilizado principalmente para la identificación de productos dentro del catálogo de Amazon.
- `{{products.0.url}}` *(text)* — URL Producto. URL de la ficha del producto con el código de afiliado del usuario
- `{{products.0.image_url}}` *(text)* — URL Imagen. URL de la imagen principal del producto
- `{{products.0.title}}` *(text)* — Título. Título del producto
- `{{products.0.features}}` *(text)* — Características. Características del producto
- `{{products.0.product_group}}` *(text)* — Categoría. Categoría del producto.
Por ejemplo: Vídeo bajo demanda
- `{{products.0.price}}` *(decimal)* — Precio actual. Precio actual (con descuentos aplicados) en la moneda establecida.
Por ejemplo: 22.99
- `{{products.0.currency}}` *(text)* — Precio:moneda. Moneda establecida.
Por ejemplo: EUR
- `{{products.0.display_amount}}` *(text)* — Precio actual:Formateado. Precio actual (con descuentos aplicados) la moneda establecida.
Por ejemplo: 22,99 €
- `{{products.0.savings_amount}}` *(decimal)* — Descuento:Importe. Precio de venta en la moneda establecida.
Por ejemplo: 17
- `{{products.0.savings_currency}}` *(text)* — Descuento:Moneda. Moneda establecida.
Por ejemplo: EUR
- `{{products.0.savings_display_amount}}` *(text)* — Descuento:Formateado. Precio de venta formateado en la moneda establecida.
Por ejemplo: 17,00 € (43%)
- `{{products.0.savings_display_percentage}}` *(decimal)* — Descuento:Porcentaje. Porcentaje de descuento.
Por ejemplo: 43
- `{{products.0.original_price}}` *(decimal)* — Precio:Importe original. Precio original o precio anterior a la oferta.
Por ejemplo: 33.99
- `{{products.0.display_original_price}}` *(text)* — Precio:Importe original formateado. Precio original formateado en la moneda establecida, calculado a partir de quitar el descuento al precio actual.
Por ejemplo: 33.99 €
- `{{products.0.savingbasis_amount}}` *(decimal)* — Precio referencia. Precio de referencia.
Por ejemplo: 55.00
- `{{products.0.savingbasis_display_amount}}` *(text)* — Precio referencia:Formateado. Precio de referencia formateado en la moneda establecida.
Por ejemplo: 55.00 €
- `{{products.0.savingbasis_label}}` *(text)* — Precio referencia:Título. Etiqueta para acompañar al precio de referencia.
Por ejemplo: Precio recomendado, Precio más bajo reciente, etc
- `{{total_products}}` *(decimal)* — Total de productos. Número total de productos extraídos después de aplicarse los distintos filtros, siendo máximo 10.
Por ejemplo: 10

## Cuenta

Necesita una cuenta de Amazon Afiliados conectada en Botize: https://botize.com/es/app/amazon_associates/authenticate

## Esta app

Todos los disparadores y acciones de Amazon Afiliados: https://botize.com/es/app/amazon_associates.md

## Cómo montar esto

Un asistente de IA (Claude, ChatGPT, Cursor…) puede crear y editar estas tareas en la cuenta del usuario a través del conector MCP de Botize, incluido en todos los planes:

    https://webhook.botize.es/mcp

- Guía de conexión: https://botize.com/es/mcp
- Mapa para agentes: https://botize.com/llms.txt
- Cuenta nueva: https://botize.com/es/join (500 operaciones gratis, sin tarjeta)

---
Resumen legible por máquinas para asistentes de IA. Versión para personas: https://botize.com/es/method/amazon_associates/get_page_results_by_keyword