Google Trends Autocomplete Endpoint
Find Google Trends topics and topic IDs for a keyword.
Getting Started
Send your API key as a bearer token. Start with the smallest request below.
Run Google Trends Autocomplete
Send the smallest useful request and read the structured response.
curl -X POST "https://api.datablue.dev/v1/data/google-trends/autocomplete" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "lipstick",
"hl": "en-IN",
"timezone": -330,
"num_results": 10
}'Example response
{
"success": true,
"source": "google_trends",
"operation": "autocomplete",
"keyword": "lipstick",
"hl": "en-IN",
"timezone": -330,
"total_results": 2,
"time_taken": 0.52,
"topics": [
{
"position": 1,
"title": "Lipstick",
"type": "Topic",
"mid": "/m/02xry"
},
{
"position": 2,
"title": "Liquid lipstick",
"type": "Topic",
"mid": "/g/11b7x..."
}
]
}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/autocomplete" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "web scraping",
"hl": "en-IN",
"timezone": -330,
"num_results": 10
}'Example response
{
"success": true,
"source": "google_trends",
"operation": "autocomplete",
"keyword": "lipstick",
"hl": "en-IN",
"timezone": -330,
"total_results": 2,
"time_taken": 0.52,
"topics": [
{
"position": 1,
"title": "Lipstick",
"type": "Topic",
"mid": "/m/02xry"
}
]
}Results and Pagination
Control how many records or pages are returned.
curl -X POST "https://api.datablue.dev/v1/data/google-trends/autocomplete" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "lipstick",
"hl": "en-IN",
"timezone": -330,
"num_results": 10
}'Example response
{
"success": true,
"source": "google_trends",
"operation": "autocomplete",
"keyword": "lipstick",
"hl": "en-IN",
"timezone": -330,
"total_results": 2,
"time_taken": 0.52,
"topics": [
{
"position": 1,
"title": "Lipstick",
"type": "Topic",
"mid": "/m/02xry"
}
]
}Location and Language
Localize results with country, language, coordinates, or delivery-location fields.
curl -X POST "https://api.datablue.dev/v1/data/google-trends/autocomplete" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "lipstick",
"hl": "en-US",
"timezone": -330,
"num_results": 10
}'Example response
{
"success": true,
"source": "google_trends",
"operation": "autocomplete",
"keyword": "lipstick",
"hl": "en-IN",
"timezone": -330,
"total_results": 2,
"time_taken": 0.52,
"topics": [
{
"position": 1,
"title": "Lipstick",
"type": "Topic",
"mid": "/m/02xry"
}
]
}Request Controls
Set device, timeout, and request-specific controls.
curl -X POST "https://api.datablue.dev/v1/data/google-trends/autocomplete" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "lipstick",
"hl": "en-IN",
"timezone": -330,
"num_results": 10,
"timeout_ms": 20000
}'Example response
{
"success": true,
"source": "google_trends",
"operation": "autocomplete",
"keyword": "lipstick",
"hl": "en-IN",
"timezone": -330,
"total_results": 2,
"time_taken": 0.52,
"topics": [
{
"position": 1,
"title": "Lipstick",
"type": "Topic",
"mid": "/m/02xry"
}
]
}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.