Entender
Google Trends y sus límites
Google Trends y sus límites. Un índice relativo y muestral, el alfa oficial, pytrends y SerpApi. El gráfico está en vivo cuando el endpoint responde.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Cargar interés pide a este servidor una serie de interés relativo, probando un motor de terceros cuando hay una clave y, si no, el endpoint del sitio web. Después de Aceptar se encola el origen de los datos, no el índice.
Cómo usarlo
- Cargar interés llama a la ruta propia de este sitio.
- Una clave configurada prueba primero el motor de terceros.
- Si no, se usa el endpoint del sitio web. Una caché corta puede responder.
- El último punto se compara con una media corta. El índice no se envía.
Qué es el número
La ayuda de Trends dice que el producto es una muestra en gran parte sin filtrar de las búsquedas. Cada punto se divide por el total de búsquedas de ese lugar y ese tiempo, y luego se escala de 0 a 100 dentro de esa petición. El mismo interés en dos lugares no significa el mismo número de búsquedas. Un término con muy poco volumen aparece como 0.
La ayuda también dice que la serie incluye ruido estadístico, más visible cuando el interés es bajo, y que los picos aislados en esas series no son evidencia de búsquedas individuales. Trends no es una encuesta. Añadir un segundo término reescala todo el gráfico, porque 100 es el pico dentro de esa petición.
Tres formas de llamarlo
Alfa oficial
La página alfa de Google dice que acepta solicitudes y que aún no puede abrir la API para todo el mundo. El anuncio del 24 de julio de 2025 dice que el acceso empieza con un grupo limitado de testers. Describe interés con escala consistente, una ventana móvil de 1.800 días hasta unos dos días atrás, agregación de diaria a anual y regiones ISO 3166-2. Esa escala es distinta del 0 a 100 del sitio. Los documentos públicos no publican una URL base, así que este sitio no llama al alfa.
pytrends
pytrends 4.9.2 (PyPI, 13 de abril de 2023) es un cliente no oficial del sitio. Su texto dice que sirve hasta que Google cambie el backend, que busca mantenedores y que el límite de peticiones no es público. El código trata el HTTP 429 como un error de cuota. Una respuesta rota es una respuesta rota.
SerpApi
SerpApi es un motor de terceros para Google Trends. Este servidor lo llama solo cuando SERPAPI_API_KEY o SERPAPI_KEY está definido, y la clave se queda en el servidor. Si esa llamada falla, la página prueba el endpoint del sitio. Si ambas fallan, el gráfico se queda vacío.
Comparación en vivo
Hasta cinco términos, un rango de tiempo, una categoría y un lugar. El servidor guarda una respuesta correcta cerca de una hora y un fallo cerca de 10 minutos. Se envía un User-Agent de navegador porque el endpoint del sitio es el que llama la página de Trends.
El selector de categorías no respondió. La lista es solo Todas las categorías.
Ejemplo etiquetado
Ejemplo. No es una medición de Google ni de este sitio.
Estos puntos están escritos en el repositorio para que el gráfico tenga forma cuando Trends no responde. No son puntuaciones de interés.
- example alpha
- example beta
| Tiempo | example alpha | example beta |
|---|---|---|
| Point 1 | 10 | 50 |
| Point 2 | 12 | 48 |
| Point 3 | 11 | 52 |
| Point 4 | 13 | 49 |
| Point 5 | 40 | 47 |
| Lugar | example alpha | example beta |
|---|---|---|
| Example northEX-N | 40 | 20 |
| Example southEX-S | 15 | 47 |
Consultas relacionadas
- example related phrase100
Consultas en alza
- example rising phraseBreakout
La misma comparación, sobre la serie de ejemplo.
example alpha · ventana 4 · razón 1.5
Último 40. Media de 4 puntos anteriores 11.5. Múltiplo 3.48. Alerta.
Alfa oficial, descrito
Sin petición. Los documentos públicos no publican una URL base.
# Official Google Trends API (alpha)
# Docs: https://developers.google.com/search/apis/trends
# Announcement, 24 July 2025: https://developers.google.com/search/blog/2025/07/trends-api
#
# Google says the alpha is open by application to a limited set of testers.
# The public docs do not publish a base URL or a self-serve key, so this repo
# does not call it. The announcement describes:
# - consistently scaled interest (the website still rescales each request from 0 to 100)
# - a rolling window of 1,800 days, with data up to about two days ago
# - daily, weekly, monthly, and yearly aggregation
# - region and subregion codes from ISO 3166-2
# The website comparison limit in that announcement is 5 terms.
# The alpha docs page says the UI compares eight. This page sends at most five.
Python · pytrends
Interés en el tiempo, región y consultas relacionadas.
"""Unofficial. pytrends 4.9.2 on PyPI (13 April 2023) calls the Trends website.
The project text says it is unofficial, that it lasts until Google changes the
backend, and that the rate limit is not public. Its source treats HTTP 429 as
a quota error. The README says it is looking for maintainers.
This is not the official alpha API.
"""
from pytrends.request import TrendReq
pytrends = TrendReq(hl="en-US", tz=360)
pytrends.build_payload(
["personalization"],
cat=0, # category id from the Trends URL, after cat=
timeframe="today 12-m", # also: now 7-d, today 1-m, today 3-m, today 5-y
geo="US", # "" is worldwide. "US-CA" is a state. Metro uses resolution="DMA".
)
interest = pytrends.interest_over_time()
regions = pytrends.interest_by_region(resolution="REGION", inc_geo_code=True)
related = pytrends.related_queries()
Python · trabajo de pico
Una comparación del tamaño de un cron. El múltiplo 1,5 es una elección del laboratorio.
# Lab choice, not a Google threshold: alert when the latest complete point
# is at least 1.5 times the mean of up to 4 earlier points.
# Drop a partial last bucket before you call spike().
# A zero baseline makes any later point look like a spike. Google’s Trends
# help says low-interest series include statistical noise.
WINDOW = 4
RATIO = 1.5
def spike(values: list[float]) -> dict | None:
if len(values) < 2:
return None
latest = values[-1]
prior = values[:-1][-WINDOW:]
baseline = sum(prior) / len(prior)
if baseline == 0:
return {"alert": latest > 0, "latest": latest, "baseline": baseline, "weak_baseline": True}
multiple = latest / baseline
return {
"alert": latest >= baseline * RATIO,
"latest": latest,
"baseline": baseline,
"multiple": multiple,
"weak_baseline": False,
}
# Schedule with cron. Back off on HTTP 429. Do not invent a point when the call fails.
# 15 * * * * python spike_check.py
Node · endpoint del sitio
Las mismas llamadas no oficiales de explore y multiline que hace este servidor.
// Unofficial. These are the Trends website endpoints pytrends calls.
// Google can change them, refuse the call, or answer HTTP 429.
// There is no published quota. Cache the result. Do not fill a failure with a guess.
const term = "personalization"
const req = JSON.stringify({
comparisonItem: [{ keyword: term, time: "today 12-m", geo: "US" }],
category: 0,
property: "",
})
const explore = new URL("https://trends.google.com/trends/api/explore")
explore.searchParams.set("hl", "en-US")
explore.searchParams.set("tz", "360")
explore.searchParams.set("req", req)
function trendsJson(text) {
const start = text.indexOf("{")
if (start < 0) throw new Error("Trends did not return a JSON object")
return JSON.parse(text.slice(start))
}
const explored = await fetch(explore, { method: "POST" })
if (!explored.ok) throw new Error("Trends explore failed: " + explored.status)
const widgets = trendsJson(await explored.text()).widgets
const series = widgets.find((widget) => widget.id === "TIMESERIES")
if (!series) throw new Error("No interest-over-time widget")
const points = new URL("https://trends.google.com/trends/api/widgetdata/multiline")
points.searchParams.set("hl", "en-US")
points.searchParams.set("tz", "360")
points.searchParams.set("req", JSON.stringify(series.request))
points.searchParams.set("token", series.token)
const lined = await fetch(points)
if (!lined.ok) throw new Error("Trends timeline failed: " + lined.status)
const timeline = trendsJson(await lined.text())
console.log(timeline.default.timelineData.slice(-3))
Node · SerpApi
Usa SERPAPI_API_KEY. La clave no se escribe en la página.
// Third-party. SerpApi sells a Google Trends engine. The key stays on the server.
// https://serpapi.com/google-trends-api
const key = process.env.SERPAPI_API_KEY
if (!key) throw new Error("SERPAPI_API_KEY is not set")
const url = new URL("https://serpapi.com/search.json")
url.searchParams.set("engine", "google_trends")
url.searchParams.set("q", "personalization")
url.searchParams.set("data_type", "TIMESERIES") // also GEO_MAP, RELATED_QUERIES
url.searchParams.set("date", "today 12-m")
url.searchParams.set("geo", "US")
url.searchParams.set("cat", "0")
url.searchParams.set("api_key", key)
const body = await (await fetch(url)).json()
console.log(body.interest_over_time?.timeline_data?.slice(-3))
Node · trabajo de pico
Sal cuando el fetch lance. No sustituyas un valor.
// Same rule as the Python job. 1.5 and 4 are choices of this lab.
const WINDOW = 4
const RATIO = 1.5
function spike(values) {
if (values.length < 2) return null
const latest = values.at(-1)
const prior = values.slice(0, -1).slice(-WINDOW)
const baseline = prior.reduce((sum, value) => sum + value, 0) / prior.length
if (baseline === 0) return { alert: latest > 0, latest, baseline, weakBaseline: true }
const multiple = latest / baseline
return { alert: latest >= baseline * RATIO, latest, baseline, multiple, weakBaseline: false }
}
// Cron or a scheduled function. If the fetch throws, log the failure and exit.
// Do not write a substitute value.
RecorridoCómo lo hicimosMostrarOcultar
El ajuste de proveedor de ejemplo está marcado abajo. Los números de eVar y de event son ejemplos. Este laboratorio no llama a Adobe.
El laboratorio de Trends pide a este servidor una serie de interés relativo, prueba un motor de terceros cuando hay una clave y, si no, llama al endpoint del sitio. Después de Aceptar, Cargar interés encola trends_view con data_source, y el laboratorio no llama a Adobe.
Preguntar a la ruta de este sitio
Cargar interés pide /api/lab/trends con los términos, el lugar, el tiempo, la categoría y la resolución. La ruta llama a loadTrends. Un fetch fallido sigue registrando data_source unreachable cuando el consentimiento está activo.
Probar el motor de terceros y luego el sitio
loadUncached llama al motor de terceros solo cuando hay una clave. Si eso lanza, o si no hay clave, llama al endpoint del sitio. Si ambas fallan, la respuesta es ok false y el gráfico se queda vacío.
Mantener una caché corta
loadTrends devuelve un acierto en caché o un fallo en caché antes de iniciar otro vuelo para la misma pregunta. La página dice que un acierto dura cerca de una hora y un fallo cerca de 10 minutos.
Comparar el último punto con una media corta
seriesSpike toma el último punto completo y la media de hasta cuatro puntos anteriores. Avisa cuando el último punto es al menos el ratio del laboratorio por esa media. Una media cero avisa solo cuando el último punto es mayor que cero.
Enviar el origen, no el índice
Después de Aceptar, trends_view envía data_source desde el source de la respuesta, o unreachable. Los puntos de 0 a 100 y la serie de ejemplo etiquetada no son parámetros.
Del código
Una clave prueba el motor de terceros. El endpoint del sitio es el respaldo. Un doble fallo se queda vacío.
if (key) {
try {
return { ...(await fromSerpApi(ask)), cached: false }
} catch (error) {
errors.push(error instanceof Error ? error.message : "SerpApi did not answer.")
}
}
try {
return { ...(await fromWebsite(ask)), cached: false }
} catch (error) {
errors.push(error instanceof Error ? error.message : "Google Trends did not answer.")
}
return {
ok: false,
error: errors[0] ?? "Trends is unreachable from this server. Nothing below is filled in with estimated interest.",
}El último punto frente a la media de la ventana anterior. El ratio sale de las constantes del laboratorio.
export function seriesSpike(values: number[], window = SPIKE_WINDOW, ratio = SPIKE_RATIO): SpikeRead | SpikeUnread {
if (values.length < 2 || !values.every((value) => Number.isFinite(value))) return { ready: false }
const latest = values[values.length - 1]
const prior = values.slice(0, -1).slice(-window)
if (!prior.length) return { ready: false }
const baseline = prior.reduce((sum, value) => sum + value, 0) / prior.length
const weakBaseline = baseline === 0
const multiple = weakBaseline ? null : latest / baseline
const alert = weakBaseline ? latest > 0 : latest >= baseline * ratio
return { ready: true, latest, baseline, points: prior.length, multiple, alert, ratio, weakBaseline }
}Google y Adobe
Google encola trends_view después de Aceptar. Adobe es un ejemplo de los mismos campos.
Después de Aceptar, Cargar interés encola trends_view. data_source es website, serpapi o unreachable. Los puntos de interés no son parámetros. El gráfico de ejemplo etiquetado no encola este evento. Esto se encola solo después de Aceptar. Este sitio no llama a Adobe.
Forma simplificada del objeto encolado después de Aceptar. Registra cualquier parámetro nuevo como dimensión personalizada con alcance de evento. Este sitio no llama a gtag('set').
dataLayer.push({
event: "trends_view",
data_source: "website",
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar110, prop110 y event110 son números de variable de ejemplo. En Launch, un elemento de datos lee el valor y una regla lo envía cuando el valor cambia. En el report suite, habilita eVar110 con asignación Most Recent y haz que expire en el hit. Una processing rule no hace falta si el elemento de datos se mapea directo a esa eVar.
Payload de alloy de ejemplo. _example es un esquema de relleno, no un inquilino real.
alloy("sendEvent", {
xdm: {
eventType: "web.webinteraction.linkClicks",
_example: {
trendsSource: "website",
},
},
})Hit de ejemplo. eVar110 tiene alcance de hit en este ejemplo. prop110 muere en el mismo hit.
s.eVar110 = "website"
s.prop110 = "website"
s.events = "event110"
s.linkTrackVars = "eVar110,prop110,events"
s.linkTrackEvents = "event110"
s.tl(true, "o", "trends_view")Traducción
Cada campo del laboratorio, el nombre en GA4 y la variable de Adobe de ejemplo. El alcance es la parte que suele perderse en la traducción.
Origen de los datos
GA4. Parámetro data_source en trends_view. Los valores son website, serpapi o unreachable.
Adobe. eVar110 de ejemplo, expira en el hit.
Alcance. Evento. Una propiedad de usuario recordaría website después de que una petición posterior falle.
Punto de interés
GA4. No se envía. La serie de 0 a 100 se queda en la página.
Adobe. prop110 de ejemplo. No escribas el índice en una prop. No se envía.
Alcance. Un valor del gráfico. No es una métrica de hit ni una propiedad de la visita.
Aviso de pico
GA4. No se envía. seriesSpike se calcula en la página.
Adobe. eVar110 de ejemplo para la palabra alert. No se envía.
Alcance. Un cálculo para esta vista. No es un evento.
Serie de ejemplo
GA4. No se envía. Los puntos del repositorio están etiquetados como que no son una medición.
Adobe. prop110 de ejemplo. No se envía.
Alcance. Datos de plantilla. No es una propiedad de usuario ni un hit.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…