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.
suggest_url	string	Google suggest URL used.
time_taken	number	API response time in seconds.

cURL Example

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
}'

System Responses

200 OK

Request processed successfully.

401 UNAUTHORIZED

Missing or invalid API key.

429 RATE LIMIT

System capacity exceeded.

500 SYSTEM FAILURE

Internal core exception.

EXAMPLE RESPONSE

{
  "success": true,
  "source": "google",
  "operation": "keyword_suggestions",
  "runtime": "http",
  "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
    }
  ]
}