API de Google Trends para vendedores de Amazon

Qué devuelve esta API

El endpoint de Google Trends recibe una palabra clave y un marketplace de Amazon, y devuelve cómo ha evolucionado en Google el interés por esa palabra clave. Sirve para una sola tarea: comprobar qué pasa fuera de Amazon antes de decidir algo solo con datos de Amazon.

La respuesta tiene cuatro partes:

El enlace documentado abarca una ventana de cinco años (de 2020-09-14 a 2025-09-14) con geo=US, así que una llamada devuelve varios años de historial. Las dos marcas de tiempo documentadas caen en domingo, lo que sugiere puntos semanales cuando monthly se deja en su valor por defecto. La lista completa de campos está en la referencia de Google Trends.

Ejemplo de petición

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/google/trends \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
    "marketplace": "US",
    "keyword": "iphone stand",
    "googleProp": "web",
    "monthly": false
  }'

• marketplace es obligatorio y admite US, JP, UK, DE, FR, IT, ES, CA, IN, MX, BR, AU y AE.
• googleProp elige la superficie de Google: web para la búsqueda web y shoppingCart para la búsqueda de Google Shopping. La búsqueda de Shopping suele estar más cerca de la intención de compra, así que ejecuta ambas cuando un término importe.
• monthly es false por defecto. Ponlo en true para agregar por meses.
• El cuerpo se valida de forma estricta: los campos desconocidos se rechazan, no se ignoran.

Usos habituales

1. Confirmar la estacionalidad. El historial mensual de búsquedas de Amazon de tendencias de investigación de palabras clave dice cuándo sube un término en Amazon. Si la curva de Google sube en los mismos meses, el patrón es más sólido. Investigación de productos de temporada muestra cómo hacerlo antes de elegir un mes.
2. Comprobar que un término no es un pico de un solo año. Varios años en una misma curva separan una temporada que se repite de una moda que ocurrió una vez.
3. Comparar el interés web y el de Shopping. Un término que sube en Google Shopping antes que en la búsqueda web merece una mirada más atenta.
4. Fijar una ventana de lanzamiento. Decide el mes en que necesitas el stock a partir del mes en que la curva empieza a subir, menos tu propio ciclo de reposición.

Límites que conviene conocer

• La puntuación es relativa. Google escala cada resultado para que su punto más alto sea 100, así que value no es un recuento de búsquedas ni es comparable entre dos peticiones distintas. Para comparar dos palabras clave, compara la forma de sus curvas, no sus niveles.
• Una palabra clave por petición. Llama al endpoint una vez por término.
• El interés en Google y la demanda en Amazon están relacionados, pero no son lo mismo. Úsalo como contraste, no como previsión de ventas en Amazon.
• Cada llamada correcta consume una unidad de facturación. Gestiona las respuestas 429 según errores y límites de uso.

Preguntas frecuentes

¿Son datos de Amazon? No. Es interés de búsqueda de Google, devuelto por la misma API y la misma cuenta que los endpoints de Amazon para que puedas ponerlos uno al lado del otro.

¿Puedo comparar varias palabras clave en una llamada? No. Cada petición cubre una palabra clave y se escala por separado, así que llama una vez por término y compara las curvas.

¿Puede llamarlo un agente de IA? Sí. El endpoint está disponible como herramienta en el servidor MCP remoto, así que un agente en Claude Code o Cursor puede sacar una curva y leerla en la misma conversación.