Google Trends Autocomplete

Return Google Trends topic autocomplete matches for a keyword. Use this stable endpoint to discover topic titles and topic IDs for trend-research workflows.

Execution model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

Parameters

Name	Type	Requirement	Description
keyword	string	Required	Trends topic search term.
hl	string	Optional	Google Trends locale.
timezone	number	Optional	Timezone offset in minutes.
num_results	number	Optional	Maximum topics to return (1-50).
timeout_ms	number	Optional	Provider timeout in milliseconds (3000-60000).

Response fields

Field	Type	Description
success	boolean	Whether the request completed successfully.
topics	array	Topic rows with position, title, type, mid, and URL.
time_taken	number	API response time in seconds.

Request and 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..."
    }
  ]
}