DataForSEO Labs Google Keyword Overview
From 14.4 credits/call
ae_dataforseo_labs_google_keyword_overview
Get Google search metrics like volume, CPC, and competition for specific keywords 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.4 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[].keywords | array | No | <em>keywords</em><br><strong>required field</strong><br>The maximum number of keywords you can specify: 700<br>The maximum number of characters for each keyword: 80<br>The maximum number of words for each keyword phrase: 10<br>the specified keywords will be converted to lowercase format, data will be provided in a separate array<p><strong>note</strong> that if some of the keywords specified in this array are omitted in the results you receive, then our database doesn't contain such keywords and cannot return data on them<br>you will not be charged for the keywords omitted in the results<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[].language_code | string | null | No | No parameter description. | — |
tasks[].language_name | string | No | <em>full name of the language</em><br><strong>required field if you don't specify</strong> <code>language_code</code><br><strong>Note:</strong> it is required to specify either <code>language_name</code> or <code>language_code</code><br>you can receive the list of available locations with their <code>language_name</code> by making a separate request to the <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>example:<br><code class="long-string">English</code> | — |
tasks[].location_code | integer | No | <em>location code</em><br><strong>required field if you don't specify</strong> <code>location_name</code><br><strong>Note:</strong> it is required to specify either <code>location_name</code> or <code>location_code</code><br>you can receive the list of available locations with their <code>location_code</code> by making a separate request to the <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>example:<br><code class="long-string">2840</code> | — |
tasks[].location_name | string | No | <em>full name of the location</em><br><strong>required field if you don't specify</strong> <code>location_code</code><br><strong>Note:</strong> it is required to specify either <code>location_name</code> or <code>location_code</code><br>you can receive the list of available locations with their <code>location_name</code> by making a separate request to the <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>example:<br><code class="long-string">United Kingdom</code> | — |
tasks[].include_serp_info | 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_overview' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"tasks": [
{
"include_serp_info": true,
"keywords": [
"all in one home battery",
"16kwh all in one",
"stackable all in one ess"
],
"language_code": "en",
"location_name": "United States"
}
]
}
}'Response exampleresponse.json
{
"cost": 0.012,
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"cost": 0.012,
"data": {
"api": "dataforseo_labs",
"function": "keyword_overview",
"include_serp_info": true,
"keywords": [
"all in one home battery"
],
"language_code": "en",
"location_name": "United States"
},
"id": "11180330-2802-0607-0000-24ce0b0824c8",
"path": [
"v3"
],
"result": [
{
"items": null,
"items_count": 0,
"language_code": "en",
"location_code": 2840,
"se_type": "google"
}
],
"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.The AI Agent Tool Stack for Cross-Border E-CommerceOne agent, one key, from sourcing to intelligence to creative to ads. See how a cross-border e-commerce team runs product sourcing, competitor research, image generation and SEO through a single AI agent stack.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.The AI Agent Tool Stack for SEO AgenciesHow SEO agencies and teams run the whole workflow from one AI agent stack — keyword research, rank tracking, backlink audits, and the emerging GEO/LLM-visibility layer — all from plain-English prompts, without juggling separate SaaS dashboards.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.

