API de Google Trends

Obtén datos históricos y actuales de popularidad de búsqueda de Google Trends. Configura engine=google_trends, pasa uno o varios términos en q y, opcionalmente, delimita la solicitud con geo, date y cat.

Endpoint

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

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
api_key	string	sí	Tu clave de API de SERP
engine	string	sí	Debe ser google_trends
q	string	sí	El o los términos de búsqueda. Se pueden separar varios términos con comas
geo	string	no	Código de ubicación. El valor predeterminado es worldwide. Consulta la lista de opciones del parámetro geo
region	string	no	country, city, subregion, o metro. Se aplica a compared_breakdown_by_region
date	string	no	Rango YYYY-MM-DD YYYY-MM-DD, o uno de now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 5-y, all
cat	string	no	ID de categoría. Consulta la lista de categorías

Ejemplo de solicitud

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();

Ejemplo de respuesta

{
  "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" } ]
  }
}

Véase también

• Resumen de Google SERP
• Estructura de la respuesta
• Lista de categorías de Google Trends
• Lista de opciones del parámetro geo