~/business/google-trends-scraper

Google Trends Scraper — Mots-clés, recherches associées et classements de catégories

Google Trends pour n'importe quel mot-clé — intérêt au fil du temps, recherches associées les plus fréquentes et en progression, et intérêt par région — et les recherches les plus fréquentes et en progression de chacune des 928 catégories de Google, dans tout pays, toute région ou toute zone métropolitaine américaine, et sur n'importe laquelle des périodes proposées par Google.

tendances de recherche TypeScript Monde

exécuter sur Apify

proooxy/google-trends-scraper — specs

catégoriebusiness / tendances de recherche

langageTypeScript

stackTypeScript

marchésMonde

sortieJSON propre, prêt pour le RAG

fonctionnalités clés

Consultations de mots-clés : intérêt au fil du temps, recherches associées les plus fréquentes et en progression avec les Breakouts signalés, et intérêt par région ou par ville, en une seule ligne

Classements par catégorie : les recherches les plus fréquentes et en progression de n'importe laquelle des 928 catégories de Google, jusqu'au troisième niveau, ou de toutes à la fois

N'importe quel lieu : un pays, une région à l'intérieur d'un pays (US-CA, GB-SCT), une zone métropolitaine américaine (US-CA-807) ou le monde entier

Toutes les périodes proposées par Google, de la dernière heure à tout l'historique depuis 2004, plusieurs dans un seul run

Mots-clés consultés dans une catégorie, pour distinguer un sens d'un autre : jaguar, la voiture

Chaque consultation et chaque recherche classée garde sa clé d'un run à l'autre, si bien que les runs planifiés constituent un historique

Un récapitulatif du run qui fait la différence entre « pas de données » et « échec » ; ce que Google refuse est retenté en fin de run

cas d’usage

SEO et planification de contenu : les recherches en hausse autour d'un sujet, et les régions où il suscite le plus d'intérêt
Études produit et marché : savoir si l'intérêt pour un produit, une marque ou une catégorie progresse, stagne ou revient à chaque saison
Veille par catégorie : ce que les gens recherchent dans des catégories comme Shopping ou Travel, ou dans n'importe quelle niche, mois après mois
Pipelines de données et tableaux de bord : des consultations planifiées sur des mots-clés, des marchés et des périodes
Fournir aux agents IA des données Google Trends via le serveur MCP d'Apify

paramètres d’entrée

Paramètre	Type	Requis	Description
`keywords`	array	optionnel	Recherches à consulter, chacune séparément, pour chaque lieu et chaque période
`keywordCategory`	string	optionnel	Catégorie dans laquelle consulter les mots-clés : son ID, son nom ou son chemin
`categories`	array	optionnel	Catégories dont lire les recherches les plus fréquentes et en progression : un nom, un chemin, un ID, ou 0 pour toutes les catégories ensemble
`subcategories`	boolean	optionnel	Classe aussi les sous-catégories de chaque catégorie, jusqu'au troisième niveau
`allCategories`	boolean	optionnel	Classe les 928 catégories : environ une heure et demie pour chaque lieu et chaque période
`countries`	array	optionnel	Un code pays, une région (US-CA), une zone métropolitaine américaine (US-CA-807), ou le monde entier
`windows`	array	optionnel	1h, 4h, 24h, 7d, 30d, 90d, 12m, 5y, ou all (depuis 2004) ; les 12 derniers mois par défaut
`maxItemsPerList`	number	optionnel	Au plus ce nombre de recherches pour chaque liste des plus fréquentes ou en progression
`maxItems`	number	optionnel	Arrête après ce nombre de résultats sur l'ensemble du run
`proxy`	object	optionnel	Utilisé pour chaque requête ; le proxy résidentiel d'Apify par défaut

Exemple de sortie

Une consultation de mot-clé, bitcoin aux États-Unis sur les 12 derniers mois :

 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}

Réduit par souci de longueur : la ligne porte aussi platform et geoRequested, et la ligne complète comptait un point par semaine, 25 recherches les plus fréquentes et 25 en progression, et tous les États. Un classement par catégorie est à la place une ligne par recherche, avec list réglé sur explore_top ou explore_rising : le 9 octobre 2026, « quince » arrivait en tête des recherches en progression de la catégorie Shopping aux États-Unis sur 12 mois, à +80 %.

Conseils

Donnez un timeout de deux heures ou plus à un run sur toutes les catégories. Les 929 classements d’un lieu sur une période prennent environ une heure et demie ; un run proche de sa limite de temps s’arrête de lui-même et marque le reste not_reached.
Une consultation pour laquelle Google n’a pas de données reste une ligne, avec status: "not_available" et la raison donnée par Google, et elle ne coûte rien.
Distinguez les sens avec une catégorie de mot-clé : jaguar dans Autos & Vehicles désigne la voiture, pas l’animal.
Lisez l’enregistrement SUMMARY du run pour distinguer un mot-clé sans données d’une consultation qui n’a pas pu être lue.

faq

Pourquoi le point le plus haut est-il toujours 100 ?

Google met chaque consultation à l'échelle de son propre point le plus haut : les chiffres sont donc un intérêt relatif, pas un nombre de recherches. Deux consultations ne sont pas sur la même échelle.

Qu'est-ce qu'un Breakout ?

La marque de Google qui remplace le pourcentage pour une recherche associée dont la hausse dépasse 5 000 %. Sa valeur est la hausse que Google donne avec elle, comme 14250.

Quelles périodes disposent de classements par catégorie ?

Seulement les 7 derniers jours, 30 jours, 90 jours et 12 mois, et seulement jusqu'au troisième niveau de l'arborescence des catégories de Google. Un classement demandé sur une autre période figure dans le récapitulatif du run comme not_available et ne coûte rien.

Les sujets associés sont-ils inclus ?

Non : Google les renvoie vides aux requêtes automatisées. Les recherches associées sont incluses, les plus fréquentes comme celles en progression.