keywords | array of string or string | Yes | - | Keywords whose SERPs to analyse, as a list or newline/comma-separated text. Up to 200 per request. |
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 | Count subdomains together with their root domain. |
item_types | string or array of string | No | - | SERP element types to count: organic, paid, featured_snippet, local_pack, ai_overview_reference. Defaults to organic and paid. |
filters | array of FilterItem | No | - | Up to 8 filters on dotted result fields, e.g. keywords_count GREATER_THAN 3, avg_position LESS_THAN 10, etv GREATER_THAN 100, domain NOT_CONTAINS ‘wikipedia’. |
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. domain, avg_position, median_position, rating, etv, keywords_count, visibility, relevant_serp_items, keywords_positions. Leave empty for the default set listed in the output description. Does not change the cost. |