get/positions_2/summary

Описание метода

Получает данные сводки по выбранному проекту за две даты.

Параметры метода

Параметр Тип Описание По умолчанию
Обязательные
project_id int ID проекта
region_index int Индекс региона
dates array(date, date) Две даты для построения сводки с разницей показетелей между этими датами
Дополнительные
competitor_id int boolean ID конкурента, добавленного в настройках проекта.
Если указан, то будет возвращена сводка по конкуренту.
0
only_exists_both_dates int boolean Учитывать ключефые фразы, присутствующие в обеих датах 0
show_dynamics int boolean Добавить в результат динамику позиций (рост/падение) 0
show_tops int boolean Добавить в результат данные по ТОПам 0
show_avg int boolean Добавить в результат среднюю позицию 0
show_visibility int boolean Добавить в результат видимость 0

Посмотреть в API Explorer

Возвращаемые данные

Параметр Тип Описание
result (объект)
dates array(date,date) Даты, участвующие в построении данной сводки
Динамика (при show_dynamics = 1)
dynamics object Динамика позиций (кол-во запросов, позиции которых увеличились/не изменились/уменьшились)

Свойства объекта:

  • all - общее кол-во запросов
  • down - кол-во запросов, позиции которых увеличились
  • stay - кол-во запросов, позиции которых не изменились
  • up - кол-во запросов, позиции которых уменьшились
Распределение по ТОПам (при show_tops = 1)
tops object

Количество запросов в ТОПах

Свойства объекта:

  • 1_3 - ТОП3
  • 1_10 - ТОП10
  • 11_30 - ТОП11-30
  • 31_50 - ТОП31-50
  • 51_100 - ТОП51-100
  • 101_10000 - ТОП100+
tops_dynamics object

Динамика запросов в ТОПах (рост/падение)

Свойства объекта: см. описание tops.

Средняя позиция (при show_avg = 1)
avgs array Средняя позиция
avg_dynamic int Динамика средней позиции (рост/падение)
Видимость (при show_visibility = 1)
visibilities array Видимость
visibility_dynamic int Динамика видимости (рост/падение)