~/business/google-trends-scraper

Google Trends Scraper — Palabras clave, búsquedas relacionadas y rankings de categorías

Google Trends para cualquier palabra clave — interés a lo largo del tiempo, búsquedas relacionadas principales y en aumento, e interés por región — y las búsquedas principales y en aumento de cualquiera de las 928 categorías de Google, en cualquier país, región o área metropolitana de EE. UU., y en cualquiera de los intervalos de tiempo de Google.

tendencias de búsqueda TypeScript Global

ejecutar en Apify

proooxy/google-trends-scraper — spec

categoríabusiness / tendencias de búsqueda

lenguajeTypeScript

stackTypeScript

mercadosGlobal

salidaJSON limpio y listo para RAG

características clave

Consultas de palabras clave: interés a lo largo del tiempo, búsquedas relacionadas principales y en aumento con los Breakouts marcados, e interés por región o ciudad, todo en una sola fila

Rankings de categorías: las búsquedas principales y en aumento de cualquiera de las 928 categorías de Google, hasta el tercer nivel, o de todas ellas

Cualquier lugar: un país, una región dentro de uno (US-CA, GB-SCT), un área metropolitana de EE. UU. (US-CA-807) o todo el mundo

Todos los intervalos de tiempo que ofrece Google, desde la última hora hasta todo lo registrado desde 2004, varios en una misma ejecución

Palabras clave consultadas dentro de una categoría, para distinguir un significado de otro: jaguar, el automóvil

Cada consulta y cada búsqueda de un ranking conserva su clave de una ejecución a otra, de modo que las ejecuciones programadas van formando un historial

Un resumen de la ejecución que distingue entre 'sin datos' y 'fallido'; lo que Google rechaza se reintenta al final de la ejecución

casos de uso

SEO y planificación de contenido: las búsquedas en aumento en torno a un tema, y las regiones donde despierta más interés
Investigación de productos y de mercado: si el interés por un producto, una marca o una categoría crece, se estanca o vuelve cada temporada
Seguimiento de categorías: lo que la gente busca en categorías como Shopping o Travel, o en cualquier nicho, mes tras mes
Pipelines de datos y dashboards: consultas programadas de palabras clave, mercados e intervalos de tiempo
Dar a agentes de IA datos de Google Trends a través del servidor MCP de Apify

parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`keywords`	array	opcional	Búsquedas a consultar, cada una por separado, en cada lugar e intervalo de tiempo
`keywordCategory`	string	opcional	Categoría dentro de la cual se consultan las palabras clave: su ID, nombre o ruta
`categories`	array	opcional	Categorías cuyas búsquedas principales y en aumento se leen: un nombre, una ruta, un ID o 0 para todas las categorías juntas
`subcategories`	boolean	opcional	Clasifica también las subcategorías de cada categoría, hasta el tercer nivel
`allCategories`	boolean	opcional	Clasifica las 928 categorías: aproximadamente una hora y media por cada lugar e intervalo de tiempo
`countries`	array	opcional	Un código de país, una región (US-CA), un área metropolitana de EE. UU. (US-CA-807) o todo el mundo
`windows`	array	opcional	1h, 4h, 24h, 7d, 30d, 90d, 12m, 5y o all (desde 2004); por defecto, los últimos 12 meses
`maxItemsPerList`	number	opcional	Como máximo este número de búsquedas de cada lista de principales o en aumento
`maxItems`	number	opcional	Se detiene tras este número de resultados en toda la ejecución
`proxy`	object	opcional	Se usa en cada solicitud; por defecto, el proxy residencial de Apify

Ejemplo de salida

Una consulta de palabra clave, bitcoin en EE. UU. durante los últimos 12 meses:

 1{
 2  "recordType": "lookup",
 3  "itemKey": "google|lookup|US|12m|all|bitcoin",
 4  "keyword": "bitcoin",
 5  "geo": "US",
 6  "geoScope": "country",
 7  "window": "12m",
 8  "category": null,
 9  "status": "ok",
10  "reason": null,
11  "points": [
12    { "time": "2025-10-05T00:00:00.000Z", "value": 37, "hasData": true, "partial": false },
13    { "time": "2025-10-12T00:00:00.000Z", "value": 40, "hasData": true, "partial": false },
14    { "time": "2026-09-27T00:00:00.000Z", "value": 16, "hasData": true, "partial": false },
15    { "time": "2026-10-04T00:00:00.000Z", "value": 17, "hasData": true, "partial": true }
16  ],
17  "relatedQueries": {
18    "top": [
19      { "query": "bitcoin price", "value": 100, "label": "100", "breakout": false },
20      { "query": "bitcoin stock", "value": 18, "label": "18", "breakout": false }
21    ],
22    "rising": [
23      { "query": "spcx stock", "value": 14250, "label": "Breakout", "breakout": true },
24      { "query": "spcx stock price", "value": 12750, "label": "Breakout", "breakout": true }
25    ]
26  },
27  "regions": [
28    { "code": "US-WY", "name": "Wyoming", "value": 100 },
29    { "code": "US-NV", "name": "Nevada", "value": 51 }
30  ],
31  "observedAt": "2026-10-09T07:32:28.150Z",
32  "url": "https://trends.google.com/trends/explore?date=today+12-m&geo=US&q=bitcoin"
33}

Recortado por brevedad: la fila también incluye platform y geoRequested, y la fila completa tenía un punto por cada semana, 25 búsquedas principales y 25 en aumento, y todos los estados. En cambio, un ranking de categoría es una fila por búsqueda, con list establecido en explore_top o explore_rising: el 9 de octubre de 2026, la búsqueda “quince” encabezó las búsquedas en aumento de la categoría Shopping en EE. UU. durante 12 meses, con +80 %.

Consejos

Asigna un timeout de dos horas o más a una ejecución de todas las categorías. Los 929 rankings de un lugar en un intervalo de tiempo llevan cerca de una hora y media; una ejecución que se acerca a su límite de tiempo se detiene sola y marca el resto como not_reached.
Una consulta para la que Google no tiene datos sigue siendo una fila, con status: "not_available" y el motivo de Google, y no cuesta nada.
Separa los significados con una categoría de palabra clave: jaguar en Autos & Vehicles es el automóvil, no el animal.
Lee el registro SUMMARY de la ejecución para distinguir una palabra clave sin datos de una consulta que no se pudo leer.

faq

¿Por qué el punto más alto siempre es 100?

Google escala cada consulta a su propio punto más alto, así que las cifras son interés relativo, no recuentos de búsquedas. Dos consultas no están en la misma escala.

¿Qué es un Breakout?

La marca de Google que aparece en lugar de un porcentaje en una búsqueda relacionada que creció más de un 5.000 %. Su valor es el aumento que Google da junto con ella, como 14250.

¿Qué intervalos de tiempo tienen rankings de categorías?

Solo los últimos 7 días, 30 días, 90 días y 12 meses, y solo hasta el tercer nivel del árbol de categorías de Google. Un ranking pedido para otro intervalo aparece en el resumen de la ejecución como not_available y no cuesta nada.

¿Se incluyen los temas relacionados?

No: Google los devuelve vacíos a las solicitudes automatizadas. Se incluyen las búsquedas relacionadas, principales y en aumento.