Domain metric trends for product categories

Inputs

• tagstring, optional

  user-defined task identifier optional field the character limit is 255; you can use this parameter to identify the task and match it with the result; you will find the specified tag value in the data object of the response

• limitinteger, optional

  the maximum number of domains in the results array optional field default value: 100; maximum value: 1000

• offsetinteger, optional

  offset in the results array of returned domains optional field default value: 0; if you specify the 10 value, the first ten domains in the results array will be omitted and the data will be provided for the successive domains

• etv_maxinteger, optional

  maximum current organic ETV of the domain optional field if specified, the API will return only domains with organic_etv lesser than the specified value

• etv_mininteger, optional

  minimum current organic ETV of the domain optional field if specified, the API will return only domains with organic_etv greater than the specified value

• filtersarray, optional

  array of results filtering parameters optional field you can add several filters at once (8 filters maximum); you should set a logical operator and, or between the conditions the following operators are supported: regex, not_regex, , =, , =, =, , in, not_in, match, not_match, ilike, not_ilike,

• order_byarray, optional

  results sorting rules optional field you can use the same values as in the filters array to sort the results; default rule: ["organic_etv,desc"]; possible sorting types: asc – results will be sorted in ascending order desc – results will be sorted in descending order; you should use a comma to set u

• correlateboolean, optional

  correlate data with previously obtained datasets optional field default value: true; if you use this parameter, our system will correlate data you obtain now with previously obtained datasets; this parameter is intended to mitigate any inconsistencies that may result from changes to our database; No

• first_datestring, optional

  first date of comparison period required field first date for which domain metrics will be provided; date format: "yyyy-mm-dd"; example: "2021-06-01"; the list available dates is available through the available history endpoint; Note: first_date cannot be greater than today’s date; Also note: the da

• item_typesarray, optional

  display results by item type optional field indicates the type of search results included in the response; Note: if the item_types array contains item types that are different from the organic object, the results will be ordered by the first item type in the array; you will not be able to sort and f

• second_datestring, optional

  second date of comparison period required field second date for which domain metrics will be provided; date format: "yyyy-mm-dd"; example: "2021-10-01"; the list available dates is available through the available history endpoint; Note: second_date cannot be greater than today’s date; Also note: the

• language_codestring, optional

  unique language identifier required field if you don’t specify language_name Note: it is required to specify either language_name or language_code; you can receive the list of available languages with their language_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/l

• language_namestring, optional

  full name of the language required field if you don’t specify language_code Note: it is required to specify either language_name or language_code; you can receive the list of available languages with their language_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/lo

• location_codeinteger, optional

  unique location identifier required field if you don’t specify location_name Note: it is required to specify either location_name or location_code; you can receive the list of available locations with their location_code by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/l

• location_namestring, optional

  full name of the location required field if you don’t specify location_code Note: it is required to specify either location_name or location_code; you can receive the list of available locations with their location_name by making a separate request to https://api.dataforseo.com/v3/dataforseo_labs/lo

• category_codesarray, optional

  product and service categories required field The maximum number of categories you can specify: 5 you can download the full list of possible categories

• include_subdomainsboolean, optional

  return subdomains in the API response optional field if false, the API response will contain main_domain only; if true, the API will return main_domain plus its subdomains (if available); default value: true

• top_categories_countinteger, optional

  number of additional domain categories optional field by using this parameter, you can receive domains relevant to additional categories that are not specified in category_codes above; to learn more about the parameter, please refer to this help center article; by default, top_categories_count is eq