targets | array of string or string | Yes | - | Domains to analyse, without scheme or www, as a list or newline/comma-separated text (e.g. example.com). ‘full’ detail runs one request per domain; ‘traffic_only’ takes up to 1000 domains in one request. |
detail | string or SelectableOption | No | full | ’full’ (default): organic and paid ranking distribution by position bucket, estimated traffic and its value, keyword counts and new, up, down and lost keyword movements. ‘traffic_only’: just estimated monthly traffic and keyword counts per SERP type, cheapest for long lists. |
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. |
fields | string or array of string | No | - | Dotted result fields to keep, e.g. target, metrics.organic.etv, metrics.organic.count, metrics.organic.pos_1, metrics.organic.pos_2_3, metrics.organic.pos_4_10, metrics.organic.is_new, metrics.organic.is_up, metrics.organic.is_down, metrics.organic.is_lost, metrics.organic.estimated_paid_traffic_cost, metrics.paid.etv, metrics.paid.count. Leave empty for the default set (see the output description). |
