API de pesquisa do Google Trends

prod-global

GET

/api/v1/google/trends/search

Status de saúde da API

Saudável Disponível Limitado Quase indisponível Sem dados

Carregando status...

Obtenha dados de tendências de pesquisa do Google, incluindo interesse ao longo do tempo, detalhamentos geográficos e consultas relacionadas, para análise de demanda e monitoramento de tendências sazonais.

Tags: Google Trends

Parâmetros

Nome	Obrigatório	Tipo	Padrão	Descrição
query	Sim	string		O termo de pesquisa ou ID do tópico a ser analisado no Google Trends (por exemplo, 'iPhone', '/m/027lnzs' para Bitcoin). Você pode fornecer até 5 termos separados por vírgulas para comparações.
language	Não	string	en	Defina o idioma dos resultados usando seu código de duas letras (por exemplo, 'en' para inglês, 'fr' para francês). Consulte Google Idioma.
geo	Não	string		O código de localização geográfica para filtrar tendências (por exemplo, 'US', 'GB'). Omita para tendências mundiais. Consulte Google Trends Locations.
region	Não	string		Refina os resultados para gráficos de região. Valores disponíveis: - COUNTRY: Resultados em nível de país. - REGION: Resultados em nível de região. - DMA: Resultados de área de mercado designada. - CITY: Resultados em nível de cidade.
data_type	Não	string		O tipo de dados de tendência a recuperar. Valores disponíveis: - INTEREST_OVER_TIME: Interesse ao longo do tempo. O valor legado TIMESERIES também é aceito. - REGION_BREAKDOWN: Detalhamento por região. O valor legado GEO_MAP também é aceito.
tz	Não	integer		Deslocamento de fuso horário em minutos (ex.: '420' para PDT). Intervalo: -1439 a 1439.
cat	Não	string	0	O código da categoria de pesquisa (ex.: '0' para todas as categorias).
gprop	Não	string		A propriedade Google para filtrar tendências. Valores disponíveis: - IMAGES: Google Images. O valor legado images também é aceito. - NEWS: Google News. O valor legado news também é aceito. - SHOPPING: Google Shopping. O valor legado froogle também é aceito. - YOUTUBE: YouTube. O valor legado youtube também é aceito.
date	Não	string		Filtro de intervalo de datas para a pesquisa. Suporta valores predefinidos (now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, all) e intervalos personalizados: aaaa-mm-dd aaaa-mm-dd (ex.: 2021-10-15 2022-05-25) ou horários aaaa-mm-ddThh aaaa-mm-ddThh dentro de 1 semana (ex.: 2022-05-19T10 2022-05-24T22, baseado em tz).

Copiar requisição

cURL

curl -X GET "https://api.justserpapi.com/api/v1/google/trends/search?query=coffee" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const res = await fetch("https://api.justserpapi.com/api/v1/google/trends/search?query=coffee", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://api.justserpapi.com/api/v1/google/trends/search"
headers = { "X-API-Key": "YOUR_API_KEY" }
params = {
  "query": "coffee"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

PHP

<?php
$url = "https://api.justserpapi.com/api/v1/google/trends/search?query=coffee";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	client := &http.Client{}
	req, _ := http.NewRequest("GET", "https://api.justserpapi.com/api/v1/google/trends/search?query=coffee", nil)
	req.Header.Set("X-API-Key", "YOUR_API_KEY")
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

Resposta

Carregando o exemplo de resposta mais recente...