DataForSEO Google Ads Search Volume

From 108 credits/call
ae_dataforseo_google_ads_search_volume

Get monthly search volume data for keywords from Google Ads via DataForSEO.

Search
From 108 credits/call

Pricing

From 108 credits/call
ConditionCharge
Each call108 credits

A fixed fee applies to each call.

The starting price applies to a single query.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
tasksarrayYesNo parameter description.—
tasks[].tagstring | nullNoNo parameter description.—
tasks[].date_tostring | nullNoNo parameter description.—
tasks[].sort_bystring | nullNoNo parameter description.—
tasks[].keywordsarrayNo<em>keywords</em><br><strong>required field</strong><br>The maximum number of keywords you can specify: 1000<br>The maximum number of characters for each keyword: 80<br>The maximum number of words for each keyword phrase: 10<br>the keywords you specify will be converted to a lowercase format<br><strong>Note #1:</strong> <a href="https://dataforseo.com/help-center/no-search-volume-data-for-some-keywords" target="_blank" rel="noopener noreferrer">Google Ads may return no data for certain groups of keywords</a>;<br><strong>Note #2:</strong> <a href="https://dataforseo.com/help-center/sv-broad-exact-phrase-match" target="_blank" rel="noopener noreferrer">Google Ads provides combined search volume values for groups of similar keywords</a><br>to obtain search volume for similar keywords, we recommend submitting such keywords in separate requests;<br><strong>Note #3:</strong> Google Ads doesn't allow using certain symbols and characters (e.g., UTF symbols, emojis), so you can't use them when setting a task;<br>to learn more about which symbols and characters can be used, please refer to <a href="https://dataforseo.com/help-center/using-symbols-in-keywords-when-setting-a-google-ads-task" target="_blank" rel="noopener noreferrer">this article</a><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[].date_fromstring | nullNoNo parameter description.—
tasks[].language_codestring | nullNoNo parameter description.—
tasks[].language_namestring | nullNoNo parameter description.—
tasks[].location_codeinteger | nullNoNo parameter description.—
tasks[].location_namestring | nullNoNo parameter description.—
tasks[].search_partnersboolean | nullNoNo parameter description.—
tasks[].location_coordinatestring | nullNoNo parameter description.—
tasks[].include_adult_keywordsboolean | 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_google_ads_search_volume' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "tasks": [
      {
        "keywords": [
          "rejuva fresh alternatives",
          "oxygen facial machine",
          "best oxygen facial machine"
        ],
        "language_code": "en",
        "location_name": "United States"
      }
    ]
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "cost": 0.09,
  "status_code": 20000,
  "status_message": "Ok.",
  "tasks": [
    {
      "cost": 0.09,
      "data": {
        "api": "keywords_data",
        "function": "search_volume",
        "keywords": [
          "rejuva fresh alternatives"
        ],
        "language_code": "en",
        "location_name": "United States",
        "se": "google_ads"
      },
      "id": "11170312-2802-0367-0000-0256bf2c7afa",
      "path": [
        "v3"
      ],
      "result": [
        {
          "keyword": "rejuva fresh alternatives",
          "language_code": "en",
          "location_code": 2840,
          "search_partners": false
        }
      ],
      "result_count": 3
    }
  ],
  "tasks_count": 1,
  "tasks_error": 0
}

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