Google Trends Search API ​
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. Supported values: 'COUNTRY', 'REGION', 'DMA', 'CITY'. | |
| data_type | No | string | The type of trend data to retrieve. Supported values: 'TIMESERIES' (Interest over time), 'GEO_MAP' (Breakdown by region). | |
| 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. Supported values: 'images', 'news', 'froogle' (Shopping), 'youtube'. | |
| 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 ​
bash
curl -X GET "https://api.justserpapi.com/api/v1/google/trends/search?query=coffee" \
-H "X-API-Key: YOUR_API_KEY"js
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...
