API de Google Trends
Google Trends muestra cómo cambia con el tiempo el interés de búsqueda por un término. interest_over_time compara hasta 5 palabras clave y devuelve una fila por momento con un valor de interés de 0 a 100 para cada una.
Los valores son relativos: 100 es el punto más alto de cualquier palabra de la consulta, así que cambian al añadir o quitar palabras. Los términos con poco volumen salen como 0. Los puntos son semanales para un año, diarios para 30 o 90 días, y por horas o minutos para un día o una semana; time da el inicio exacto. El último punto suele estar aún en recuento (partial).
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Google Trends, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Comparar el interés de búsqueda en Google Trendsinterest_over_time | Envía keywords, una lista de 1 a 5 términos, para obtener filas con time, date_from, date_to, values (interés de 0 a 100 por palabra), period_averages y partial. | $8.81 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Google Trends?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
interest_over_timeComparar el interés de búsqueda en Google Trends Envía | keywords | country, language, search_type, time_window | Entrega síncrona | — | $8.81 por 1.000 solicitudes | time · date_from · date_to · values · period_averages · partial · platform |
¿Qué significan los parámetros de Google Trends interest_over_time?
Envía keywords, una lista de 1 a 5 términos, para obtener filas con time, date_from, date_to, values (interés de 0 a 100 por palabra), period_averages y partial. Elige country (mundial si se omite), time_window (day, week, month, quarter, year o five_years; por defecto year) y search_type (web, news, youtube, images o shopping).
keywordsObligatorio- Lista de 1 a 5 términos para comparar, como
["openai", "anthropic"]. Cada término tiene como máximo 80 caracteres y 10 palabras.Ayuda de Google Trends: preguntas frecuentes sobre los datos — La ayuda de Google Trends explica que los datos salen de una muestra de búsquedas reales, que cada punto se divide entre el total de búsquedas de su zona y periodo y se escala de 0 a 100, y que los términos con poco volumen aparecen como 0. La fuente respalda el significado de `values`; los filtros `country`, `time_window` y `search_type` de esta API los define EveryInfra y la fuente no garantiza los resultados. · Consultada countryOpcional- Código de país de dos letras, como
us,gbojp, donde medir el interés. Sin él, mundial. languageOpcional- Código de idioma de dos letras, como
enoja. Normalmente no hace falta. search_typeOpcional- Qué búsqueda de Google medir:
web(por defecto),news,youtube,imagesoshopping. time_windowOpcional- Periodo:
day,week,month(30 días),quarter(90 días),year(12 meses, por defecto) ofive_years.
Cómo usar la API de Google Trends
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_trends","action":"interest_over_time","params":{"keywords":"<keywords>"}}'
Preguntas sobre la API de Google Trends
¿Cómo llamo a la API de Google Trends?
Envía POST /api/v1/social con platform igual a google_trends, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Google Trends?
Devuelve JSON estructurado. Por ejemplo, el esquema de interest_over_time incluye time, date_from, date_to y values. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Google Trends?
La ayuda de Google Trends explica que los datos salen de una muestra de búsquedas reales, que cada punto se divide entre el total de búsquedas de su zona y periodo y se escala de 0 a 100, y que los términos con poco volumen aparecen como 0. La fuente respalda el significado de values; los filtros country, time_window y search_type de esta API los define EveryInfra y la fuente no garantiza los resultados.
¿Qué parámetros son obligatorios?
Depende de la acción. interest_over_time requiere keywords.
¿Las acciones de Google Trends responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.