DataForSEO Labs Google Keyword Suggestions
From 14.4 credits/call
ae_dataforseo_labs_google_keyword_suggestions
Discover long-tail keyword ideas and trends based on a seed term using DataForSEO.
From 14.4 credits/call
Pricing
From 14.4 credits/call
| Condition | Charge |
|---|---|
| Without clickstream data (default) | 14.4 credits base fee + 0.2 credits per returned record |
| With clickstream data | 28.8 credits base fee + 0.3 credits per returned record |
Charges depend on clickstream inclusion and the number of results actually returned.
The starting price is the base query fee without clickstream data; returned records add the listed charges.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
tasks | array | Yes | No parameter description. | — |
tasks[].tag | string | null | No | No parameter description. | — |
tasks[].limit | integer | null | No | No parameter description. | — |
tasks[].offset | integer | null | No | No parameter description. | — |
tasks[].filters | array | null | No | No parameter description. | — |
tasks[].keyword | string | No | <em>keyword</em><br><strong>required field</strong><br>UTF-8 encoding<br>the keywords will be converted to lowercase format;<p>learn more about rules and limitations of <code>keyword</code> and <code>keywords</code> fields in DataForSEO APIs in this <a href="https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis" rel="noopener noreferrer" target="_blank">Help Center article</a> | — |
tasks[].order_by | array | null | No | No parameter description. | — |
tasks[].exact_match | boolean | null | No | No parameter description. | — |
tasks[].offset_token | string | null | No | No parameter description. | — |
tasks[].language_code | string | null | No | No parameter description. | — |
tasks[].language_name | string | null | No | No parameter description. | — |
tasks[].location_code | integer | null | No | No parameter description. | — |
tasks[].location_name | string | null | No | No parameter description. | — |
tasks[].ignore_synonyms | boolean | null | No | No parameter description. | — |
tasks[].include_serp_info | boolean | null | No | No parameter description. | — |
tasks[].include_seed_keyword | boolean | null | No | No parameter description. | — |
tasks[].include_clickstream_data | boolean | null | No | No parameter description. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_dataforseo_labs_google_keyword_suggestions' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"tasks": [
{
"include_seed_keyword": true,
"keyword": "combination fume hoods & cabinets",
"language_code": "en",
"limit": 20,
"location_code": 2840
}
]
}
}'Response exampleresponse.json
{
"cost": 0.012,
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"cost": 0.012,
"data": {
"api": "dataforseo_labs",
"function": "keyword_suggestions",
"include_seed_keyword": true,
"keyword": "combination fume hoods & cabinets",
"language_code": "en",
"limit": 20
},
"id": "11170314-2802-0399-0000-32793712800a",
"path": [
"v3"
],
"result": [
{
"items": null,
"items_count": 0,
"language_code": "en",
"location_code": 2840,
"offset": 0,
"offset_token": "eyJDdXJyZW50T2Zmc2V0IjowLCJSZXF1ZXN0RGF0YSI6eyJrZXl3b3JkIjoiY29tYmluYXRpb24gZnVtZSBob29kcyAmIGNhYmluZXRzIiwiaW5jbHVkZV9zZWVkX2tleXdvcmQiOnRydWUsImZ1bGxfbWF0Y2giOmZhbHNlLCJsb2FkX3NlcnBfaW5mbyI6ZmFsc2UsInNlYXJjaF9hZnRlcl90b2tlbiI6bnVsbCwiaWdub3JlX3N5bm9ueW1z"
}
],
"result_count": 1
}
],
"tasks_count": 1,
"tasks_error": 0
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows
B2B Industrial Keyword Research with AI AgentsHow industrial and B2B export marketers run multi-country keyword research with an AI agent — hand it seed terms and target countries, and it pulls per-country search volume, expands long-tails, and groups everything into a multi-country keyword library by country and intent.Long-Tail Keyword Discovery at Scale with AI AgentsLet an AI agent expand a single seed keyword into hundreds of long-tails, enrich each with search volume and difficulty, and group them by topic and intent into a ready-to-publish content plan.Keyword Research with DataForSEO via AI AgentsLet an AI agent run full keyword research with DataForSEO — pull search volume, CPC, difficulty, keyword suggestions and ranked keywords from one plain-English prompt, then group them into a keyword list.

