scrollport
Back to SEO and search

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
Last accepted verification

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.
Updated
18 August 2026

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.