Google Ads Search Volume

DataForSEO

Return Google Ads keyword search volume and competition metrics by location and language.

Capability: Keyword demand research
Current price: $0.1260/call
Availability: Ready to run

What this API does

Returns current Google Ads search-volume metrics, monthly search history, paid competition and bid data for a bounded keyword set. The live endpoint charges one fixed task fee whether the request contains one keyword or 1,000, so Scrollport prices the task once and never invents a per-keyword charge.

Agents select this operation with tool ID dataforseo.google-ads-search-volume, then inspect its current executable contract before a run.

Public input and output shape

Input

keywordsarray · required

Keyword phrases of at most 10 words each.

minItems: 1 · maxItems: 1000

language_namestring · optional

Value supplied for language name.

minLength: 1 · maxLength: 100

location_namestring · optional

Value supplied for location name.

minLength: 1 · maxLength: 200

search_partnersboolean · optional

Value supplied for search partners.

Output

itemsarray

Returned items value.

items_countnumber

Returned items count value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "dataforseo.google-ads-search-volume",
  "input": {
    "keywords": [
      "seo tools"
    ],
    "language_name": "English",
    "location_name": "United States"
  }
}

Output

{
  "items": [
    {
      "cpc": 8.15,
      "keyword": "seo tools",
      "competition": "MEDIUM",
      "search_volume": 12100,
      "monthly_searches": [
        {
          "year": 2026,
          "month": 7,
          "search_volume": 12100
        }
      ],
      "competition_index": 34
    }
  ],
  "items_count": 1
}

Teaching errors and limitations

invalid_input: Provide 1–1,000 keyword phrases of at most 80 characters and 10 words each.example: {"keywords":["seo tools"],"location_name":"United States","language_name":"English"}
rate_limited: The Google Ads live endpoint is limited to 12 requests per minute for the provider account.Retry after the current minute rather than splitting one bounded keyword batch into more calls.
configuration_error: DataForSEO account access, funding, or cost controls blocked the request.Fund and verify the server-side DataForSEO account, then retry unchanged.

Use Google Ads Search Volume with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.