Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
List the keywords a domain ranks for according to DataForSEO Labs, with search volume, CPC, competition, difficulty and intent
| App | DataForSEO |
| Operation ID | dataforseo_get_keywords_for_site |
| Type | Action |
| Connection | dataforseo (required) |
| Credits per run | Free |
| Agent / MCP tool | Yes |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
target | string | Yes | - | Domain to pull ranking keywords for, without scheme or www (e.g. example.com). |
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. |
include_subdomains | boolean | No | True | Include keywords the domain’s subdomains rank for. |
include_serp_info | boolean | No | False | Also return SERP facts per keyword: result types on the page, number of results and the check URL. |
filters | array of FilterItem | No | - | Up to 8 filters on dotted result fields, e.g. keyword_info.search_volume GREATER_THAN 500, keyword_properties.keyword_difficulty LESS_THAN 40, keyword CONTAINS ‘best’, search_intent_info.main_intent EQUALS commercial. |
orders | array of OrderItem | No | - | Sort by up to 3 dotted result fields, e.g. keyword_info.search_volume DESC. |
limit | integer | No | 100 | Maximum number of rows to return (1 to 1000). Defaults to 100. Each row is billed by DataForSEO, so keep this as small as the task needs. |
offset | integer | No | - | Number of rows to skip, for paging. |
fields | string or array of string | No | - | Dotted result fields to keep, e.g. keyword, keyword_info.search_volume, keyword_info.cpc, keyword_info.competition_level, keyword_info.monthly_searches, keyword_info.search_volume_trend.yearly, keyword_properties.keyword_difficulty, search_intent_info.main_intent, serp_info.serp_item_types, avg_backlinks_info.backlinks. Leave empty for the default set listed in the output description. Does not change the cost. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
field | string or SelectableOption | Yes | - | The field to filter on, must be one of the current selected metrics or dimensions. |
operator | string | Yes | - | The operator to use for filtering. Must be one of the supported values. Use REGEXP_MATCH to search/filter by multiple OR values like ’.(summer|holiday).’ |
value | string | Yes | - | The value to filter by, always as a string: text, a number, or a regex. For IN_LIST and NOT_IN_LIST, pass the values as one comma-separated string such as ‘a,b,c’, not as an array. For regex values, escape backslashes once in the JSON string: write \b for a word boundary, not \b. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
field | string or SelectableOption | Yes | - | The field to sort by. must be one of the current selected metrics or dimensions. |
direction | string | Yes | - | The order to sort by, must be one of ‘ASC’, ‘DESC’ |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | |
label | string | Yes | - |
List[Dict]
Returns one row per keyword with the dotted columns keyword, keyword_info., keyword_properties., search_intent_info., avg_backlinks_info. and, when requested, serp_info.*.
Fields: keyword, keyword_info.search_volume, keyword_info.cpc, keyword_info.competition_level, keyword_properties.keyword_difficulty, search_intent_info.main_intent
Example:
[
{
"keyword": "seo tools",
"keyword_info.search_volume": 40500,
"keyword_info.cpc": 6.2,
"keyword_info.competition_level": "MEDIUM",
"keyword_properties.keyword_difficulty": 72,
"search_intent_info.main_intent": "commercial"
}
]