~/business/google-trends-scraper

Google Trends Scraper — Palavras-chave, pesquisas relacionadas e rankings de categorias

Google Trends para qualquer palavra-chave — interesse ao longo do tempo, pesquisas relacionadas principais e em ascensão, e interesse por região — e as pesquisas principais e em ascensão de qualquer uma das 928 categorias do Google, em qualquer país, região ou área metropolitana dos EUA, e em qualquer um dos períodos que o Google oferece.

tendências de pesquisa TypeScript Global

executar no Apify

proooxy/google-trends-scraper — especificações

categoriabusiness / tendências de pesquisa

linguagemTypeScript

stackTypeScript

mercadosGlobal

saídaJSON limpo e pronto para RAG

principais recursos

Consultas de palavras-chave: interesse ao longo do tempo, pesquisas relacionadas principais e em ascensão com os Breakouts marcados, e interesse por região ou cidade, tudo em uma única linha

Rankings de categorias: as pesquisas principais e em ascensão de qualquer uma das 928 categorias do Google, até o terceiro nível, ou de todas elas

Qualquer lugar: um país, uma região dentro dele (US-CA, GB-SCT), uma área metropolitana dos EUA (US-CA-807) ou o mundo todo

Todos os períodos que o Google oferece, da última hora a tudo desde 2004, vários em uma única execução

Palavras-chave consultadas dentro de uma categoria, para distinguir um significado do outro: jaguar, o carro

Cada consulta e cada pesquisa de um ranking mantém sua chave de uma execução para outra, de modo que as execuções agendadas vão formando um histórico

Um resumo da execução que distingue entre 'sem dados' e 'falhou'; o que o Google recusa é tentado de novo no fim da execução

casos de uso

SEO e planejamento de conteúdo: as pesquisas em ascensão em torno de um tema, e as regiões onde ele desperta mais interesse
Pesquisa de produto e de mercado: se o interesse por um produto, uma marca ou uma categoria cresce, estagna ou volta a cada temporada
Acompanhamento de categorias: o que as pessoas pesquisam em categorias como Shopping ou Travel, ou em qualquer nicho, mês após mês
Pipelines de dados e dashboards: consultas agendadas por palavras-chave, mercados e períodos
Dar a agentes de IA dados do Google Trends através do servidor MCP da Apify

parâmetros de entrada

Parâmetro	Tipo	Obrigatório	Descrição
`keywords`	array	opcional	Pesquisas a consultar, cada uma separadamente, em cada lugar e período
`keywordCategory`	string	opcional	Categoria dentro da qual as palavras-chave são consultadas: seu ID, nome ou caminho
`categories`	array	opcional	Categorias cujas pesquisas principais e em ascensão são lidas: um nome, um caminho, um ID ou 0 para todas as categorias juntas
`subcategories`	boolean	opcional	Classifica também as subcategorias de cada categoria, até o terceiro nível
`allCategories`	boolean	opcional	Classifica as 928 categorias: cerca de uma hora e meia para cada lugar e período
`countries`	array	opcional	Um código de país, uma região (US-CA), uma área metropolitana dos EUA (US-CA-807) ou o mundo todo
`windows`	array	opcional	1h, 4h, 24h, 7d, 30d, 90d, 12m, 5y ou all (desde 2004); os últimos 12 meses por padrão
`maxItemsPerList`	number	opcional	No máximo este número de pesquisas de cada lista de principais ou em ascensão
`maxItems`	number	opcional	Interrompe após este número de resultados em toda a execução
`proxy`	object	opcional	Usado em cada requisição; o proxy residencial da Apify por padrão

Exemplo de saída

Uma consulta de palavra-chave, bitcoin nos EUA nos ú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}

Reduzido por brevidade: a linha também traz platform e geoRequested, e a linha completa tinha um ponto para cada semana, 25 pesquisas principais e 25 em ascensão, e todos os estados. Um ranking de categoria, em vez disso, é uma linha por pesquisa, com list definido como explore_top ou explore_rising: em 9 de outubro de 2026, a pesquisa “quince” liderou as pesquisas em ascensão da categoria Shopping nos EUA em 12 meses, com +80%.

Dicas

Dê a uma execução de todas as categorias um timeout de duas horas ou mais. Os 929 rankings de um lugar em um período levam cerca de uma hora e meia; uma execução perto do seu limite de tempo se interrompe sozinha e marca o restante como not_reached.
Uma consulta para a qual o Google não tem dados continua sendo uma linha, com status: "not_available" e o motivo do Google, e não custa nada.
Separe os significados com uma categoria de palavra-chave: jaguar em Autos & Vehicles é o carro, não o animal.
Leia o registro SUMMARY da execução para distinguir uma palavra-chave sem dados de uma consulta que não pôde ser lida.

faq

Por que o ponto mais alto é sempre 100?

O Google normaliza cada consulta pelo seu próprio ponto mais alto, então os números são interesse relativo, não contagens de pesquisas. Duas consultas não estão na mesma escala.

O que é um Breakout?

A marca do Google que aparece no lugar de uma porcentagem em uma pesquisa relacionada que cresceu mais de 5.000%. Seu valor é o aumento que o Google informa junto com ela, como 14250.

Quais períodos têm rankings de categorias?

Somente os últimos 7 dias, 30 dias, 90 dias e 12 meses, e somente até o terceiro nível da árvore de categorias do Google. Um ranking pedido para outro período aparece no resumo da execução como not_available e não custa nada.

Os tópicos relacionados estão incluídos?

Não: o Google os devolve vazios para solicitações automatizadas. As pesquisas relacionadas estão incluídas, principais e em ascensão.