Google Trends Search API

prod-global

GET

/api/v1/google/trends/search

API health status

Healthy Available Limited Mostly unavailable No data

Loading health status...

Get Google trends Search data, including interest over time, geo breakdowns, and related queries, for demand analysis and seasonal trend monitoring.

Tags: Google Trends

Parameters

Name	Required	Type	Default	Description
query	Yes	string		The search term or topic ID to analyze in Google Trends (e.g., 'iPhone', '/m/027lnzs' for Bitcoin). You can provide up to 5 terms separated by commas for comparisons.
language	No	string	en	Set the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See Google Language.
geo	No	string		The geographic location code to filter trends (e.g., 'US', 'GB'). Omit for worldwide trends. See Google Trends Locations.
region	No	string		Refines results for region charts. Available Values: - COUNTRY: Country-level results. - REGION: Region-level results. - DMA: Designated market area results. - CITY: City-level results.
data_type	No	string		The type of trend data to retrieve. Available Values: - INTEREST_OVER_TIME: Interest over time. Legacy value TIMESERIES is also accepted. - REGION_BREAKDOWN: Breakdown by region. Legacy value GEO_MAP is also accepted.
tz	No	integer		Time zone offset in minutes (e.g., '420' for PDT). Range: -1439 to 1439.
cat	No	string	0	The search category code (e.g., '0' for all categories).
gprop	No	string		The Google property to filter trends. Available Values: - IMAGES: Google Images. Legacy value images is also accepted. - NEWS: Google News. Legacy value news is also accepted. - SHOPPING: Google Shopping. Legacy value froogle is also accepted. - YOUTUBE: YouTube. Legacy value youtube is also accepted.
date	No	string		Date range filter for the search. Supports predefined values (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) and custom ranges: yyyy-mm-dd yyyy-mm-dd (e.g. 2021-10-15 2022-05-25) or hourly yyyy-mm-ddThh yyyy-mm-ddThh within 1 week (e.g. 2022-05-19T10 2022-05-24T22, based on tz).

Copy Request

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))
}

Response

Loading the latest response example...