crawlbaseDocs
Se connecter

Google Trends

Parsez la page « Trending now » de Google Trends en un tableau structuré de recherches tendance avec des métriques de volume de recherche, des décompositions de tendances, des filtres et de la pagination.

Utilisation de l'API

Ajoutez &scraper=google-trends à une requête Crawling API. Encodez en URL l'URL cible dans le paramètre url. Les filtres tels que geo, la plage temporelle et la catégorie 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/trending?geo=AE-DU' \
  --data-urlencode 'scraper=google-trends' -G
from crawlbase import CrawlingAPI

api = CrawlingAPI({'token': 'YOUR_TOKEN'})
res = api.get(
    'https://trends.google.com/trending?geo=AE-DU',
    {'scraper': 'google-trends'}
)

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/trending?geo=AE-DU',
  { scraper: 'google-trends' }
);
const data = JSON.parse(res.body);
require 'crawlbase'
api = Crawlbase::API.new(token: 'YOUR_TOKEN')

res = api.get('https://trends.google.com/trending?geo=AE-DU', scraper: 'google-trends')
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/trending?geo=AE-DU

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.

trends
array
Recherches tendance sur la page, ordonnées par position.
trends[].position
integer
Rang de la tendance dans la page (commence à 1).
trends[].title
string
Requête tendance telle qu'elle apparaît sur la page Google Trends.
trends[].searchVolume
string
Volume de recherche abrégé pour la tendance (par exemple 20K+, 1M+).
trends[].searchVolumeText
string
Libellé de volume de recherche localisé et lisible (par exemple 20K+ searches).
trends[].increasePercentage
string
Augmentation récente de l'intérêt de recherche, telle qu'affichée sur la page.
trends[].started
string
Quand la tendance a commencé à monter, sous forme de chaîne temporelle relative (par exemple 6 hours ago).
trends[].status
string
Statut de la tendance tel qu'affiché par Google (généralement Active ou Lasted).
trends[].trendBreakdown
array<string>
Sous-requêtes associées que Google regroupe sous cette tendance.
trends[].trendBreakdownMoreCount
integer
Nombre de sous-requêtes supplémentaires au-delà de celles listées dans trendBreakdown.
trendsCount
integer
Nombre total de tendances renvoyées dans trends.
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 les tendances sont restreintes.
filters.timeRange
string
Libellé de plage temporelle par laquelle la page est filtrée (par exemple Past 7 days).
filters.category
string
Libellé du filtre de catégorie (par exemple All categories).
filters.trendType
string
Libellé du filtre de type de tendance (par exemple All trends).
filters.sortBy
string
Libellé de l'ordre de tri (par exemple By relevance, By search volume).
filters.updatedAtText
string
Libellé localisé indiquant la dernière mise à jour de la page par Google.
pagination
object
État de la pagination pour la requête en cours.
pagination.currentPage
integer
Index de la page de la réponse en cours (commence à 1).
pagination.itemsPerPage
integer
Nombre de tendances renvoyées par Google par page.
pagination.totalItems
integer
Nombre total de tendances disponibles sur toutes les pages pour les filtres en cours.
pagination.hasNextPage
boolean
true lorsque davantage de tendances sont disponibles sur une page suivante.
pagination.hasPreviousPage
boolean
true lorsqu'une page précédente est disponible.

Exemple de réponse

{
  "trends": [
    {
      "position": 1,
      "title": "al maktoum international airport (dwc)",
      "searchVolume": "20K+",
      "searchVolumeText": "20K+ searches",
      "increasePercentage": "600%",
      "started": "6 hours ago",
      "status": "Active",
      "trendBreakdown": ["dubai international airport"],
      "trendBreakdownMoreCount": 0
    }
  ],
  "trendsCount": 5,
  "filters": {
    "geo": "Dubai",
    "timeRange": "Past 7 days",
    "category": "All categories",
    "trendType": "All trends",
    "sortBy": "By relevance",
    "updatedAtText": "Updated Jun 2, 2:56 PM"
  },
  "pagination": {
    "currentPage": 1,
    "itemsPerPage": 25,
    "totalItems": 25,
    "hasNextPage": false,
    "hasPreviousPage": false
  }
}