API Google Trends

Récupérez des données historiques et actuelles de popularité de recherche depuis Google Trends. Définissez engine=google_trends, transmettez un ou plusieurs termes dans q, et limitez éventuellement le champ de la requête avec geo, date et cat.

Endpoint

GET https://serp.shifter.io/v1?engine=google_trends&api_key=YOUR_API_KEY

Paramètres

Paramètre	Type	Requis	Description
api_key	string	oui	Votre clé API SERP
engine	string	oui	Doit être google_trends
q	string	oui	Le ou les termes de recherche. Plusieurs termes peuvent être séparés par des virgules
geo	string	non	Code de localisation. Par défaut, worldwide. Voir la liste des options du paramètre geo
region	string	non	country, city, subregion, ou metro. S’applique à compared_breakdown_by_region
date	string	non	Plage YYYY-MM-DD YYYY-MM-DD, ou l’une des valeurs now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 5-y, all
cat	string	non	ID de catégorie. Voir la liste des catégories

Exemple de requête

curl

curl "https://serp.shifter.io/v1?engine=google_trends&api_key=YOUR_API_KEY&geo=US&q=american%20football&date=2021-01-01%202022-01-01"

Python

import requests

params = {
    "engine": "google_trends",
    "api_key": "YOUR_API_KEY",
    "geo": "US",
    "q": "american football",
    "date": "2021-01-01 2022-01-01",
}
r = requests.get("https://serp.shifter.io/v1", params=params)
data = r.json()

Node.js

import fetch from 'node-fetch';

const url = 'https://serp.shifter.io/v1?' + new URLSearchParams({
  engine: 'google_trends',
  api_key: 'YOUR_API_KEY',
  geo: 'US',
  q: 'american football',
  date: '2021-01-01 2022-01-01',
});
const data = await (await fetch(url)).json();

Exemple de réponse

{
  "search_parameters": {
    "engine": "google_trends",
    "q": "american football",
    "geo": "US",
    "date": "2021-01-01 2022-01-01"
  },
  "interest_over_time": {
    "timeline_data": [
      {
        "date": "Jan 3 - 9, 2021",
        "timestamp": "1609632000",
        "values": [
          { "query": "american football", "value": "100", "extracted_value": 100 }
        ]
      }
    ],
    "averages": [ { "query": "american football", "value": 68 } ]
  },
  "interest_by_region": [
    { "geo": "US-FL", "location": "Florida", "value": "100" }
  ],
  "related_queries": {
    "top": [ { "query": "nfl scores", "value": "100" } ],
    "rising": [ { "query": "nfl playoffs", "value": "Breakout" } ]
  }
}

Voir aussi

• Présentation de Google SERP
• Structure de la réponse
• Liste des catégories Google Trends
• Liste des options du paramètre geo