La búsqueda inversa de palabras clave es una operación: le das un ASIN y te devuelve los términos por los que ese producto aparece en las búsquedas.
Parece lo bastante simple como para que casi nadie compruebe qué vuelve exactamente. Y si te saltas esa comprobación, todo juicio construido sobre esos términos queda desviado desde el principio.
Qué contiene realmente la respuesta
El campo items.keyword está definido en la documentación así:
Términos por los que este ASIN alcanzó las 3 primeras páginas de resultados de búsqueda de Amazon, en los últimos 30 días o en un mes natural dado
Esa frase tiene dos matices y ambos importan.
Primero, son "las 3 primeras páginas", no "todas". Si para un término el ASIN está en la página 8, ese término no aparece en la respuesta. Así que el resultado no es "todas las palabras clave relevantes para este producto", sino "todas las palabras clave en las que este producto tiene visibilidad apreciable".
Segundo, es una instantánea sobre una ventana. Sin month obtienes los últimos 30 días; con month (formato yyyyMM) obtienes un mes natural concreto del pasado.
Juntos explican una confusión frecuente: un listing nuevo o mal posicionado devuelve muy pocos términos, y eso no es un fallo de los datos. Está informando con precisión de una cosa: esa es toda la visibilidad que el producto tiene ahora mismo. A la inversa, que un ASIN consolidado devuelva mil términos es igual de normal.
Lo cual convierte el propio recuento en una métrica. Si un competidor devuelve 1.800 términos y tú 90, esa distancia ya es parte de la conclusión y no necesita más análisis.
Qué recibe una petición
| Parámetro | Obligatorio | Nota |
|---|---|---|
asin | Sí | Un único ASIN, diez letras mayúsculas y dígitos |
marketplace | No | Por defecto US |
month | No | Mes natural pasado como yyyyMM; omítelo para los últimos 30 días |
page | No | Número de página, hasta 100 |
size | No | Elementos por página, hasta 100 |
Fíjate en que asin es singular y no una lista: el procesamiento por lotes ocurre en tu lado, en un bucle, lo cual importa al estimar el volumen de llamadas. Veinte competidores son al menos veinte llamadas, multiplicadas de nuevo por páginas si hay que paginar cada uno.
Hay un techo de paginación, y cambia las conclusiones
El endpoint recupera como máximo 2.000 registros. El campo total de la respuesta es el número total de términos que cumplen la condición, y puede ser mayor que 2.000.
Cuando esas dos cifras no coinciden, tienes los primeros 2.000, no todos.
La consecuencia práctica: tienes que preocuparte por el orden, porque lo que se corta es la cola. Si buscas términos de alto valor, perder la cola apenas importa. Si estás midiendo "cuántos términos cubre este ASIN", esa cifra es total, no el número de filas que llegaste a descargar.
Registrar ambas es más fiable que registrar una.
Cómo leer los campos de posición
Cada término trae dos objetos de posición, rankPosition (orgánica) y adPosition (publicitaria), con la misma forma:
| Campo | Significado |
|---|---|
page | Qué página |
pageSize | Cuántos resultados hay en esa página |
index | Posición dentro de la página actual |
position | Posición sobre el total de resultados |
updatedTime | Cuándo se midió esta posición |
Compara con position, no con page. pageSize no es fijo: los resultados por página pueden variar según el marketplace y el término. Si la posición 1 de la página 2 va por delante de la posición 60 de la página 1 no se puede responder solo con números de página, y position lo responde directamente.
updatedTime merece su propia columna. Las posiciones se mueven, y un número de posición sin marca de tiempo no se puede juzgar vigente dos semanas después.
Además, que rankPosition y adPosition estén ambos presentes significa que tienes posición orgánica en ese término y además te anuncias en él. Solo adPosition significa que la visibilidad está comprada. Cómo optimizar palabras clave en Amazon cubre qué hacer con esa distinción.
badges: dónde te coloca el término
badges es un array cuyos valores incluyen naturalSearching, amazonChoice, editorialRecommendations, fourStar, highlyRated, sponsorBrand, sponsorVideo y ads.
Responde de dónde viene la visibilidad. "Este término da impresiones" significa algo muy distinto si viene de resultados orgánicos que si viene de un espacio publicitario. La columna se gana el sitio sobre todo en análisis de competencia: si la posición de un rival en un término es ganada o comprada se lee directamente en los badges.
Consultarte a ti y consultar a la competencia es el mismo endpoint
A la búsqueda le da igual de quién sea el ASIN. Mismo endpoint, dos usos:
Consúltate a ti para responder "por qué términos estoy recibiendo impresiones". Ahí empieza la optimización.
Consulta a la competencia para responder "en qué términos tienen posición". Lo habitual es lanzar de tres a cinco rivales comparables, unir los términos devueltos y restar los tuyos: la diferencia es tu lista de puntos ciegos.
Una advertencia sobre ese método: los términos de un competidor no son automáticamente adecuados para ti. Puede tener variantes, tallas o certificaciones que tú no tienes, lo que hace que algunos términos le sean relevantes a él y no a ti. La diferencia es una lista de candidatos, no una lista de tareas.
Tres lecturas erróneas habituales
Una: los términos devueltos son los términos de búsqueda del backend del competidor. No lo son. Los términos de backend los rellena el vendedor y solo su cuenta los ve, como datos autorizados. La búsqueda devuelve términos por los que el ASIN apareció realmente en resultados públicos. Fuentes distintas, y sin correspondencia entre ellas.
Dos: más términos significa mejor producto. Más términos significa visibilidad más amplia. Un término que nunca produce un pedido gana su sitio en tu lista sobre todo como algo a excluir. Cantidad y calidad son lecturas separadas.
Tres: con una búsqueda basta.
Una búsqueda es una instantánea. Juzgar una tendencia exige varios puntos en el tiempo: traer algunos meses naturales consecutivos con month dice bastante más que cualquier resultado aislado.
Una vez tienes los términos
La búsqueda es solo recuperación. A partir de ahí hay dos direcciones:
- Para fusionar estos términos en una biblioteca mantenible, mira Construye tu propia biblioteca de palabras clave
- Para decidir qué hacer con cada término, mira Cómo optimizar palabras clave en Amazon
Preguntas
¿Puedo pasar varios ASIN a la vez?
El parámetro asin de la búsqueda inversa es singular, así que procesar por lotes significa iterar en tu lado.
¿Los ASIN padre e hijo devuelven los mismos términos? No necesariamente. La visibilidad puede diferir entre variaciones, sobre todo en categorías donde talla o color varían mucho. Para una comparación rigurosa, anota qué ASIN consultaste en lugar de escribir "este producto" de forma imprecisa.
¿Por qué la posición difiere de lo que veo al buscar a mano?
Los resultados dependen de la ubicación, del estado de sesión, del comportamiento previo y del momento, así que una búsqueda manual rara vez reproduce las condiciones de muestreo del endpoint. Juzga la frescura con updatedTime en lugar de intentar "verificarlo" a mano.
¿Hasta dónde llega el histórico?
El parámetro month acepta un mes natural. Consulta la documentación del endpoint para el rango realmente disponible en lugar de asumir que existe cualquier mes arbitrariamente antiguo.