Google Trends Explore · Documentation Crawlbase

Utilisation de l'API

Ajoutez &scraper=google-trends-explore à une requête Crawling API. Encodez en URL l'URL cible dans le paramètre url. Les filtres tels que geo, la plage temporelle, la catégorie et le type de recherche sont passés en paramètres de query string sur l'URL Google Trends elle-même.

curl 'https://api.crawlbase.com/?token=YOUR_TOKEN' \
  --data-urlencode 'url=https://trends.google.com/trends/explore?q=/g/11cs9m5kkd' \
  --data-urlencode 'scraper=google-trends-explore' -G
from crawlbase import CrawlingAPI

api = CrawlingAPI({'token': 'YOUR_TOKEN'})
res = api.get(
    'https://trends.google.com/trends/explore?q=/g/11cs9m5kkd',
    {'scraper': 'google-trends-explore'}
)

import json
data = json.loads(res['body'])
const { CrawlingAPI } = require('crawlbase');
const api = new CrawlingAPI({ token: 'YOUR_TOKEN' });

const res = await api.get(
  'https://trends.google.com/trends/explore?q=/g/11cs9m5kkd',
  { scraper: 'google-trends-explore' }
);
const data = JSON.parse(res.body);
require 'crawlbase'
api = Crawlbase::API.new(token: 'YOUR_TOKEN')

res = api.get('https://trends.google.com/trends/explore?q=/g/11cs9m5kkd', scraper: 'google-trends-explore')
data = JSON.parse(res.body)

Exemple d'URL en entrée

L'URL passée dans le paramètre url (décodée pour plus de lisibilité) :

https://trends.google.com/trends/explore?q=/g/11cs9m5kkd

Structure de la réponse

Corps de la réponse JSON. Les types de champs peuvent être null lorsque la page source omet la valeur.

topic

string

Libellé de sujet résolu pour la requête Explore (un nom de sujet du Knowledge Graph, ou le terme de recherche littéral lorsqu'aucun sujet n'est apparié).

filters

object

État des filtres reflété par la page, décodé depuis l'URL Google Trends.

filters.geo

string

Libellé de géographie résolu (pays ou sous-région) auquel la comparaison est restreinte. Vaut Worldwide par défaut lorsqu'aucun geo n'est défini.

filters.timeRange

string

Libellé de plage temporelle par laquelle la comparaison est filtrée (par exemple Past 12 months, Past 7 days).

filters.category

string

Libellé du filtre de catégorie (par exemple All categories).

filters.searchType

string

Libellé du filtre de type de recherche (par exemple Web Search, YouTube Search).

filters.description

string

Résumé lisible des filtres actifs (généralement geo joint à timeRange).

interestOverTime

object

Bloc du graphique d'intérêt au fil du temps.

interestOverTime.title

string

Titre de section tel que rendu par Google (généralement Interest over time).

interestOverTime.timeline

array

Points de la série temporelle pour le sujet, ordonnés chronologiquement.

interestOverTime.timeline[].date

string

Libellé de date localisé pour le point de données.

interestOverTime.timeline[].value

number

Score d'intérêt normalisé pour le point de données, sur une échelle de 0 à 100 où 100 correspond au pic de popularité pour la période.

interestOverTime.timelineCount

integer

Nombre total de points dans timeline.

interestBySubregion

object

Bloc d'intérêt par sous-région (pays, sous-région, agglomération ou ville, selon le geo actif).

interestBySubregion.title

string

Titre de section tel que rendu par Google (généralement Interest by region, Interest by sub-region, etc.).

interestBySubregion.view

string

Onglet de vue actif (généralement Top ou Rising).

interestBySubregion.totalItems

integer

Nombre total de régions disponibles sur toutes les pages.

interestBySubregion.paginationText

string

Résumé de pagination localisé (par exemple Showing 1-5 of 87 regions).

interestBySubregion.items

array

Régions sur la page en cours, ordonnées par position.

interestBySubregion.items[].position

integer

Rang de la région dans la réponse (commence à 1).

interestBySubregion.items[].name

string

Nom de la région tel qu'affiché par Google.

interestBySubregion.items[].value

number

Score d'intérêt normalisé pour la région sur une échelle de 0 à 100.

relatedTopics

object

Bloc des sujets associés.

relatedTopics.title

string

Titre de section tel que rendu par Google (généralement Related topics).

relatedTopics.view

string

Onglet de vue actif (généralement Top ou Rising).

relatedTopics.items

array

Sujets associés sur la page en cours, ordonnés par position.

relatedTopics.items[].position

integer

Rang du sujet dans la réponse (commence à 1).

relatedTopics.items[].name

string

Nom du sujet tel qu'affiché par Google.

relatedTopics.items[].value

string

Libellé de score tel qu'affiché par Google : une chaîne de croissance en pourcentage (par exemple +250%) sur la vue Rising, ou Breakout pour les nouvelles entrées ; un score relatif sur la vue Top.

relatedTopics.items[].link

string

URL Google Trends Explore pour le sujet associé.

relatedQueries

object

Bloc des requêtes associées.

relatedQueries.title

string

Titre de section tel que rendu par Google (généralement Related queries).

relatedQueries.view

string

Onglet de vue actif (généralement Top ou Rising).

relatedQueries.items

array

Requêtes associées sur la page en cours, ordonnées par position.

relatedQueries.items[].position

integer

Rang de la requête dans la réponse (commence à 1).

relatedQueries.items[].name

string

Requête de recherche telle qu'affichée par Google.

relatedQueries.items[].value

string

relatedQueries.items[].link

string

URL Google Trends Explore pour la requête associée.

Exemple de réponse

{
  "topic": "YouTube Music",
  "filters": {
    "geo": "Worldwide",
    "timeRange": "Past 12 months",
    "category": "All categories",
    "searchType": "Web Search",
    "description": "Worldwide, Past 12 months"
  },
  "interestOverTime": {
    "title": "Interest over time",
    "timeline": [
      {
        "date": "Jun 15, 2025",
        "value": 100
      }
    ],
    "timelineCount": 53
  },
  "interestBySubregion": {
    "title": "Interest by region",
    "view": "Top",
    "totalItems": 87,
    "paginationText": "Showing 1-5 of 87 regions",
    "items": [
      {
        "position": 1,
        "name": "South Africa",
        "value": 100
      }
    ]
  },
  "relatedTopics": {
    "title": "Related topics",
    "view": "Rising",
    "items": [
      {
        "position": 1,
        "name": "Spotify - Topic",
        "value": "Breakout",
        "link": "https://trends.google.com/trends/explore?q=/g/11hy9l1k8h&date=today+12-m"
      }
    ]
  },
  "relatedQueries": {
    "title": "Related queries",
    "view": "Rising",
    "items": [
      {
        "position": 1,
        "name": "youtube muzica",
        "value": "+250%",
        "link": "https://trends.google.com/trends/explore?q=youtube+muzica&date=today+12-m"
      }
    ]
  }
}