target | string | Yes | - | Domain to find competitors 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. |
item_types | string or array of string | No | - | SERP element types to compare on: organic, paid, featured_snippet, local_pack, ai_overview_reference. Defaults to organic and paid. |
max_rank_group | integer | No | - | Only count keywords where the target ranks within this position (e.g. 10 for page one). Leave empty for the top 100. |
exclude_top_domains | boolean | No | False | Leave out very large sites such as Wikipedia, Amazon and YouTube that rank for almost everything. |
filters | array of FilterItem | No | - | Up to 8 filters on dotted result fields, e.g. intersections GREATER_THAN 50, full_domain_metrics.organic.etv GREATER_THAN 1000, domain CONTAINS ‘.co.uk’. |
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, sum_position, intersections, full_domain_metrics.organic.etv, full_domain_metrics.organic.count, metrics.organic.etv, metrics.organic.count, competitor_metrics.organic.etv, competitor_metrics.organic.count. Leave empty for the default set (see the output description). |