Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Get search volume for up to 1000 keywords from DataForSEO: official Google Ads volume with CPC and monthly history, DataForSEO’s clickstream-normalised volume, or AI search volume (monthly prompts …
| App | DataForSEO |
| Operation ID | dataforseo_get_search_volume |
| Type | Action |
| Connection | dataforseo (required) |
| Credits per run | Free |
| Agent / MCP tool | Yes |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
keywords | array of string or string | Yes | - | Keywords to get search volume for, as a list or newline/comma-separated text. Up to 1000 per request. |
source | string or SelectableOption | No | google_ads | ’google_ads’ (default): official Google Ads volume, CPC, competition and up to 4 years of monthly history; billed per request whatever the keyword count, and at most 12 requests per minute. ‘dataforseo’: DataForSEO’s clickstream-normalised volume with 12 months of history, also billed per request. ‘ai’: estimated monthly prompts in AI assistants such as ChatGPT, with 12 months of history. |
location | string or SelectableOption | No | 2840 | Country or location: a two-letter country code (us, gb, de…), a DataForSEO location code (2840 = United States), or a full location name such as ‘London,England,United Kingdom’. Defaults to the United States. |
language | string or SelectableOption | No | en | Language code of the search results, e.g. en, de, es, fr, nl. Defaults to en. |
date_from | string | No | - | google_ads only: start of the monthly history in YYYY-MM-DD format (up to 4 years back). Defaults to the last 12 months. |
date_to | string | No | - | google_ads only: end of the monthly history in YYYY-MM-DD format. |
search_partners | boolean | No | False | google_ads only: include Google search partner sites in the volume. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | |
label | string | Yes | - |
List[Dict]
Returns one row per keyword. google_ads: keyword, search_volume, cpc, competition, competition_index, low_top_of_page_bid, high_top_of_page_bid, monthly_searches (list of year, month, search_volume). dataforseo: keyword, search_volume. ai: keyword, ai_search_volume, ai_monthly_searches (list).
Fields: keyword, search_volume, cpc, competition, competition_index, monthly_searches
Example:
[
{
"keyword": "seo tools",
"search_volume": 40500,
"cpc": 6.15,
"competition": "MEDIUM",
"competition_index": 55,
"monthly_searches": [
{
"year": 2026,
"month": 8,
"search_volume": 40500
}
]
}
]