Google Trends Interest Endpoint
Compare Google Trends interest over time for one to five terms or topics.
Getting Started
Send your API key as a bearer token. Start with the smallest request below.
Run Google Trends Interest
Send the smallest useful request and read the structured response.
curl -X POST "https://api.datablue.dev/v1/data/google-trends/interest" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keywords": [
"cake",
"milk"
],
"geo": "IN",
"timeframe": "today 12-m",
"hl": "en-US",
"timezone": -330
}'Example response
{
"success": true,
"source": "google_trends",
"operation": "interest",
"keywords": [
"cake",
"milk"
],
"geo": "IN",
"timeframe": "today 12-m",
"hl": "en-US",
"timezone": -330,
"property_name": "",
"total_points": 2,
"time_taken": 1.24,
"timeline": [
{
"time": "1752537600",
"formatted_time": "Jul 2025",
"formatted_axis_time": "Jul 2025",
"values": {
"cake": 62,
"milk": 77
},
"has_data": {
"cake": true,
"milk": true
},
"formatted_values": {
"cake": "62",
"milk": "77"
}
},
{
"time": "1753142400",
"formatted_time": "Jul 2025",
"formatted_axis_time": "Jul 2025",
"values": {
"cake": 58,
"milk": 74
},
"has_data": {
"cake": true,
"milk": true
},
"formatted_values": {
"cake": "58",
"milk": "74"
}
}
]
}Options
Query and Target
Set the search term, identifier, or source URL that defines the request.
curl -X POST "https://api.datablue.dev/v1/data/google-trends/interest" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keywords": [
"web scraping",
"data extraction"
],
"geo": "IN",
"timeframe": "today 12-m",
"hl": "en-US",
"timezone": -330
}'Example response
{
"success": true,
"source": "google_trends",
"operation": "interest",
"keywords": [
"cake"
],
"geo": "IN",
"timeframe": "today 12-m",
"hl": "en-US",
"timezone": -330,
"property_name": "",
"total_points": 2,
"time_taken": 1.24,
"timeline": [
{
"time": "1752537600",
"formatted_time": "Jul 2025",
"formatted_axis_time": "Jul 2025",
"values": {
"cake": 62,
"milk": 77
},
"has_data": {
"cake": true,
"milk": true
},
"formatted_values": {
"cake": "62",
"milk": "77"
}
}
]
}Location and Language
Localize results with country, language, coordinates, or delivery-location fields.
curl -X POST "https://api.datablue.dev/v1/data/google-trends/interest" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keywords": [
"cake",
"milk"
],
"geo": "",
"timeframe": "today 12-m",
"hl": "en-US",
"timezone": -330
}'Example response
{
"success": true,
"source": "google_trends",
"operation": "interest",
"keywords": [
"cake"
],
"geo": "IN",
"timeframe": "today 12-m",
"hl": "en-US",
"timezone": -330,
"property_name": "",
"total_points": 2,
"time_taken": 1.24,
"timeline": [
{
"time": "1752537600",
"formatted_time": "Jul 2025",
"formatted_axis_time": "Jul 2025",
"values": {
"cake": 62,
"milk": 77
},
"has_data": {
"cake": true,
"milk": true
},
"formatted_values": {
"cake": "62",
"milk": "77"
}
}
]
}Filters and Sorting
Narrow or order the returned records.
curl -X POST "https://api.datablue.dev/v1/data/google-trends/interest" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keywords": [
"cake",
"milk"
],
"geo": "IN",
"timeframe": "today 12-m",
"hl": "en-US",
"timezone": -330,
"property_name": ""
}'Example response
{
"success": true,
"source": "google_trends",
"operation": "interest",
"keywords": [
"cake"
],
"geo": "IN",
"timeframe": "today 12-m",
"hl": "en-US",
"timezone": -330,
"property_name": "",
"total_points": 2,
"time_taken": 1.24,
"timeline": [
{
"time": "1752537600",
"formatted_time": "Jul 2025",
"formatted_axis_time": "Jul 2025",
"values": {
"cake": 62,
"milk": 77
},
"has_data": {
"cake": true,
"milk": true
},
"formatted_values": {
"cake": "62",
"milk": "77"
}
}
]
}Request Controls
Set device, timeout, and request-specific controls.
curl -X POST "https://api.datablue.dev/v1/data/google-trends/interest" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keywords": [
"cake",
"milk"
],
"geo": "IN",
"timeframe": "today 12-m",
"hl": "en-US",
"timezone": -330,
"timeout_ms": 30000
}'Example response
{
"success": true,
"source": "google_trends",
"operation": "interest",
"keywords": [
"cake"
],
"geo": "IN",
"timeframe": "today 12-m",
"hl": "en-US",
"timezone": -330,
"property_name": "",
"total_points": 2,
"time_taken": 1.24,
"timeline": [
{
"time": "1752537600",
"formatted_time": "Jul 2025",
"formatted_axis_time": "Jul 2025",
"values": {
"cake": 62,
"milk": 77
},
"has_data": {
"cake": true,
"milk": true
},
"formatted_values": {
"cake": "62",
"milk": "77"
}
}
]
}Response
Read success first, then consume the endpoint-specific records and pagination fields shown below.
Error Handling
Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.