Google Trends Search API
Scrape detailed search interest data, regional trends, and related queries from Google Trends. Programmatically analyze the relative popularity of search terms over time to compare keywords, analyze seasonal fluctuations, and drill down into specific geographic regions.
Tags: Google API
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
Example:
json
{
"code": 200,
"message": "success",
"data": {
"interest_over_time": {
"timerange_data": [],
"timeline_data": [
{
"date": "Feb 23 – Mar 1, 2025",
"timestamp": "1740268800",
"values": [
{
"query": "coffee",
"value": 74,
"extracted_value": "74"
}
]
},
{
"date": "Mar 2 – 8, 2025",
"timestamp": "1740873600",
"values": [
{
"query": "coffee",
"value": 69,
"extracted_value": "69"
}
]
},
{
"date": "Mar 9 – 15, 2025",
"timestamp": "1741478400",
"values": [
{
"query": "coffee",
"value": 75,
"extracted_value": "75"
}
]
},
{
"date": "Mar 16 – 22, 2025",
"timestamp": "1742083200",
"values": [
{
"query": "coffee",
"value": 74,
"extracted_value": "74"
}
]
},
{
"date": "Mar 23 – 29, 2025",
"timestamp": "1742688000",
"values": [
{
"query": "coffee",
"value": 73,
"extracted_value": "73"
}
]
},
{
"date": "Mar 30 – Apr 5, 2025",
"timestamp": "1743292800",
"values": [
{
"query": "coffee",
"value": 74,
"extracted_value": "74"
}
]
},
{
"date": "Apr 6 – 12, 2025",
"timestamp": "1743897600",
"values": [
{
"query": "coffee",
"value": 73,
"extracted_value": "73"
}
]
},
{
"date": "Apr 13 – 19, 2025",
"timestamp": "1744502400",
"values": [
{
"query": "coffee",
"value": 70,
"extracted_value": "70"
}
]
},
{
"date": "Apr 20 – 26, 2025",
"timestamp": "1745107200",
"values": [
{
"query": "coffee",
"value": 69,
"extracted_value": "69"
}
]
},
{
"date": "Apr 27 – May 3, 2025",
"timestamp": "1745712000",
"values": [
{
"query": "coffee",
"value": 73,
"extracted_value": "73"
}
]
},
{
"date": "May 4 – 10, 2025",
"timestamp": "1746316800",
"values": [
{
"query": "coffee",
"value": 74,
"extracted_value": "74"
}
]
},
{
"date": "May 11 – 17, 2025",
"timestamp": "1746921600",
"values": [
{
"query": "coffee",
"value": 71,
"extracted_value": "71"
}
]
},
{
"date": "May 18 – 24, 2025",
"timestamp": "1747526400",
"values": [
{
"query": "coffee",
"value": 73,
"extracted_value": "73"
}
]
},
{
"date": "May 25 – 31, 2025",
"timestamp": "1748131200",
"values": [
{
"query": "coffee",
"value": 78,
"extracted_value": "78"
}
]
},
{
"date": "Jun 1 – 7, 2025",
"timestamp": "1748736000",
"values": [
{
"query": "coffee",
"value": 73,
"extracted_value": "73"
}
]
},
{
"date": "Jun 8 – 14, 2025",
"timestamp": "1749340800",
"values": [
{
"query": "coffee",
"value": 77,
"extracted_value": "77"
}
]
},
{
"date": "Jun 15 – 21, 2025",
"timestamp": "1749945600",
"values": [
{
"query": "coffee",
"value": 84,
"extracted_value": "84"
}
]
},
{
"date": "Jun 22 – 28, 2025",
"timestamp": "1750550400",
"values": [
{
"query": "coffee",
"value": 77,
"extracted_value": "77"
}
]
},
{
"date": "Jun 29 – Jul 5, 2025",
"timestamp": "1751155200",
"values": [
{
"query": "coffee",
"value": 80,
"extracted_value": "80"
}
]
},
{
"date": "Jul 6 – 12, 2025",
"timestamp": "1751760000",
"values": [
{
"query": "coffee",
"value": 86,
"extracted_value": "86"
}
]
},
{
"date": "Jul 13 – 19, 2025",
"timestamp": "1752364800",
"values": [
{
"query": "coffee",
"value": 86,
"extracted_value": "86"
}
]
},
{
"date": "Jul 20 – 26, 2025",
"timestamp": "1752969600",
"values": [
{
"query": "coffee",
"value": 89,
"extracted_value": "89"
}
]
},
{
"date": "Jul 27 – Aug 2, 2025",
"timestamp": "1753574400",
"values": [
{
"query": "coffee",
"value": 88,
"extracted_value": "88"
}
]
},
{
"date": "Aug 3 – 9, 2025",
"timestamp": "1754179200",
"values": [
{
"query": "coffee",
"value": 84,
"extracted_value": "84"
}
]
},
{
"date": "Aug 10 – 16, 2025",
"timestamp": "1754784000",
"values": [
{
"query": "coffee",
"value": 83,
"extracted_value": "83"
}
]
},
{
"date": "Aug 17 – 23, 2025",
"timestamp": "1755388800",
"values": [
{
"query": "coffee",
"value": 80,
"extracted_value": "80"
}
]
},
{
"date": "Aug 24 – 30, 2025",
"timestamp": "1755993600",
"values": [
{
"query": "coffee",
"value": 82,
"extracted_value": "82"
}
]
},
{
"date": "Aug 31 – Sep 6, 2025",
"timestamp": "1756598400",
"values": [
{
"query": "coffee",
"value": 83,
"extracted_value": "83"
}
]
},
{
"date": "Sep 7 – 13, 2025",
"timestamp": "1757203200",
"values": [
{
"query": "coffee",
"value": 79,
"extracted_value": "79"
}
]
},
{
"date": "Sep 14 – 20, 2025",
"timestamp": "1757808000",
"values": [
{
"query": "coffee",
"value": 74,
"extracted_value": "74"
}
]
},
{
"date": "Sep 21 – 27, 2025",
"timestamp": "1758412800",
"values": [
{
"query": "coffee",
"value": 79,
"extracted_value": "79"
}
]
},
{
"date": "Sep 28 – Oct 4, 2025",
"timestamp": "1759017600",
"values": [
{
"query": "coffee",
"value": 87,
"extracted_value": "87"
}
]
},
{
"date": "Oct 5 – 11, 2025",
"timestamp": "1759622400",
"values": [
{
"query": "coffee",
"value": 78,
"extracted_value": "78"
}
]
},
{
"date": "Oct 12 – 18, 2025",
"timestamp": "1760227200",
"values": [
{
"query": "coffee",
"value": 78,
"extracted_value": "78"
}
]
},
{
"date": "Oct 19 – 25, 2025",
"timestamp": "1760832000",
"values": [
{
"query": "coffee",
"value": 81,
"extracted_value": "81"
}
]
},
{
"date": "Oct 26 – Nov 1, 2025",
"timestamp": "1761436800",
"values": [
{
"query": "coffee",
"value": 75,
"extracted_value": "75"
}
]
},
{
"date": "Nov 2 – 8, 2025",
"timestamp": "1762041600",
"values": [
{
"query": "coffee",
"value": 84,
"extracted_value": "84"
}
]
},
{
"date": "Nov 9 – 15, 2025",
"timestamp": "1762646400",
"values": [
{
"query": "coffee",
"value": 91,
"extracted_value": "91"
}
]
},
{
"date": "Nov 16 – 22, 2025",
"timestamp": "1763251200",
"values": [
{
"query": "coffee",
"value": 86,
"extracted_value": "86"
}
]
},
{
"date": "Nov 23 – 29, 2025",
"timestamp": "1763856000",
"values": [
{
"query": "coffee",
"value": 94,
"extracted_value": "94"
}
]
},
{
"date": "Nov 30 – Dec 6, 2025",
"timestamp": "1764460800",
"values": [
{
"query": "coffee",
"value": 89,
"extracted_value": "89"
}
]
},
{
"date": "Dec 7 – 13, 2025",
"timestamp": "1765065600",
"values": [
{
"query": "coffee",
"value": 89,
"extracted_value": "89"
}
]
},
{
"date": "Dec 14 – 20, 2025",
"timestamp": "1765670400",
"values": [
{
"query": "coffee",
"value": 91,
"extracted_value": "91"
}
]
},
{
"date": "Dec 21 – 27, 2025",
"timestamp": "1766275200",
"values": [
{
"query": "coffee",
"value": 99,
"extracted_value": "99"
}
]
},
{
"date": "Dec 28, 2025 – Jan 3, 2026",
"timestamp": "1766880000",
"values": [
{
"query": "coffee",
"value": 100,
"extracted_value": "100"
}
]
},
{
"date": "Jan 4 – 10, 2026",
"timestamp": "1767484800",
"values": [
{
"query": "coffee",
"value": 87,
"extracted_value": "87"
}
]
},
{
"date": "Jan 11 – 17, 2026",
"timestamp": "1768089600",
"values": [
{
"query": "coffee",
"value": 90,
"extracted_value": "90"
}
]
},
{
"date": "Jan 18 – 24, 2026",
"timestamp": "1768694400",
"values": [
{
"query": "coffee",
"value": 88,
"extracted_value": "88"
}
]
},
{
"date": "Jan 25 – 31, 2026",
"timestamp": "1769299200",
"values": [
{
"query": "coffee",
"value": 86,
"extracted_value": "86"
}
]
},
{
"date": "Feb 1 – 7, 2026",
"timestamp": "1769904000",
"values": [
{
"query": "coffee",
"value": 94,
"extracted_value": "94"
}
]
},
{
"date": "Feb 8 – 14, 2026",
"timestamp": "1770508800",
"values": [
{
"query": "coffee",
"value": 97,
"extracted_value": "97"
}
]
},
{
"date": "Feb 15 – 21, 2026",
"timestamp": "1771113600",
"values": [
{
"query": "coffee",
"value": 98,
"extracted_value": "98"
}
]
},
{
"date": "Feb 22 – 28, 2026",
"timestamp": "1771718400",
"values": [
{
"query": "coffee",
"value": 98,
"extracted_value": "98"
}
]
}
]
}
},
"requestId": "1a810300-7ac8-4510-bffe-4c865f34c3fd",
"timestamp": 1771923300010
}