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/request
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 check its current inputs and price before a run.

Inputs and outputs

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

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

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
}

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

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.