Google Keyword Suggestions

Return Google autocomplete keyword suggestions for a seed term with country, language, client, and result-count controls.

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	Seed keyword.
country	string	Optional	Two-letter country code.
language	string	Optional	Google UI language code.
client	string	Optional	Google suggest client.
num_results	number	Optional	Maximum suggestions 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.
suggestions	array	Suggestions with position, keyword, relevance, and suggestion_type when available.
time_taken	number	API response time in seconds.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/google/keyword-suggestions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keyword": "kiro beauty",
  "country": "in",
  "language": "en",
  "num_results": 10
}'

Example response

{
  "success": true,
  "source": "google",
  "operation": "keyword_suggestions",
  "keyword": "kiro beauty",
  "country": "in",
  "language": "en",
  "client": "firefox",
  "total_results": 3,
  "time_taken": 0.38,
  "suggestions": [
    {
      "position": 1,
      "keyword": "kiro beauty lipstick",
      "relevance": 900
    },
    {
      "position": 2,
      "keyword": "kiro beauty kajal",
      "relevance": 810
    }
  ]
}