DataForSEO Google Bulk Keyword Difficulty

From 14.6 credits/call
ae_dataforseo_google_bulk_keyword_difficulty

Check the ranking difficulty for up to 1,000 keywords at once using DataForSEO Labs.

Search
From 14.6 credits/call

Pricing

From 14.6 credits/call
ConditionCharge
Base processing fee per call14.4 credits
Per item0.2 credits

Charges depend on submitted items.

The starting price is for one submitted query item.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
tasksarrayYesNo parameter description.—
tasks[].tagstring | nullNoNo parameter description.—
tasks[].keywordsarrayNo<em>target keywords</em><br><strong>required field</strong><br>UTF-8 encoding<br>maximum number of keywords you can specify in this array: 1000<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[].language_codestring | nullNoNo parameter description.—
tasks[].language_namestringNo<em>full name of the language</em><br><strong>required field if don't specify <code>language_code</code></strong><br>you can receive the list of available languages 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 don't specify <code>location_name</code></strong><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 don't specify <code>location_code</code></strong><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>—

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_google_bulk_keyword_difficulty' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "tasks": [
      {
        "keywords": [
          "weather"
        ],
        "language_code": "en",
        "location_code": 2840,
        "tag": "ae_rename_acceptance_20261115"
      }
    ]
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "cost": 0.01212,
  "status_code": 20000,
  "status_message": "Ok.",
  "tasks": [
    {
      "cost": 0.01212,
      "data": {
        "api": "dataforseo_labs",
        "function": "bulk_keyword_difficulty",
        "keywords": [
          "weather"
        ],
        "language_code": "en",
        "location_code": 2840,
        "se_type": "google"
      },
      "id": "11151309-2802-0392-0000-fdd3f590ba77",
      "path": [
        "v3"
      ],
      "result": [
        {
          "items": [
            {}
          ],
          "items_count": 1,
          "language_code": "en",
          "location_code": 2840,
          "se_type": "google",
          "total_count": 1
        }
      ],
      "result_count": 1
    }
  ],
  "tasks_count": 1,
  "tasks_error": 0
}

This example shows part of the response. Copied content is valid JSON.