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.

Search
From 14.4 credits/call

Pricing

From 14.4 credits/call
ConditionCharge
Without clickstream data (default)14.4 credits base fee + 0.2 credits per returned record
With clickstream data28.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.

ParameterTypeRequiredDescriptionDefault
tasksarrayYesNo parameter description.—
tasks[].tagstring | nullNoNo parameter description.—
tasks[].keywordsarrayNo<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_codestring | nullNoNo parameter description.—
tasks[].language_namestringNo<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_codeintegerNo<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_namestringNo<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_infoboolean | nullNoNo parameter description.—
tasks[].include_clickstream_databoolean | nullNoNo parameter description.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request 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
JSONPartial content
{
  "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