Данные о динамике проекта (устаревшая версия)

Актуальная версия API для просмотра сводки.
Эта версия перестанет поддерживаться 01.03.2018 года.

Действие Параметры GET Параметры POST Ответ
Получить данные о динамике проекта за указанный промежуток времени &oper=get&module=mod_keywords
&func=history_summary
project_id, group_id, date1, date2, searcher, region_key, region_lang {
visibility,
up_visibility,
avg,
up_avg,
count,
top_percent,
up_position,
stay_position,
down_position,
count3,
count10,
count30,
count50,
count100,
count10000,
up3,
up10,
up30,
up50,
up100,
up10000
}
Получить данные о динамике проекта за указанный промежуток времени по датам проверок позиций &oper=get&module=mod_keywords
&func=history_summary_by_dates
project_id, searcher, group_id, region_key, region_lang, date1, date2, type_range, graph_type {
date,
avg,
visibility,
count3,
count10,
count30,
count50,
count100,
count10000
}

Описание параметров POST:

  • project_id – ID проекта;
  • group_id – ID группы запросов ("-1" – все группы);
  • date1 – с даты (международный формат YYYY-MM-DD);
  • date2 – по дату (международный формат YYYY-MM-DD);
  • searcher – описание значений здесь;
  • type_range – описание значений здесь;
  • region_key – номер региона (номер региона общей выдачи "-1", сравнение по регионам "-2");
  • region_lang – код языка выдачи (по умолчанию - русский "ru");
  • Обратите внимание, что если в настройках проекта выбран не русский язык, то необходимо обязательно указывать данный параметр.
  • graph_type – показатель:
    • 0 - ТОП100;
    • 1 - Средняя позиция;
    • 2 - Видимость

Описание ответа:

  • visibility – значение показателя Видимость за указанный период времени;
  • up_visibility – динамика показателя Видимость (увеличился/уменьшился);
  • avg – значение показателя Средняя позиция за указанный период времени;
  • up_avg – динамика показателя Средняя позиция (увеличился/уменьшился);
  • count – общее количество запросов, позиции которых увеличились/не изменились/уменьшились за указанный период времени;
  • top_percent – процент запросов в ТОПе за указанный период времени;
  • up_position – количество запросов, позиции которых увеличились за указанный период времени;
  • stay_position – количество запросов, позиции которых не изменились за указанный период времени;
  • down_position – количество запросов, позиции которых уменьшились за указанный период времени;
  • count3/count10/count11-30/count31-50/count51-100/count100+ – количество запросов в ТОП3/ТОП10/ТОП11-30/ТОП31-50/ТОП51-100/ТОП100+ за указанный период времени;
  • up3/up10/up11-30/up31-50/up51-100/up100+ – динамика позиций в ТОП3/ТОП10/ТОП11-30/ТОП31-50/ТОП51-100/ТОП100+ за указанный период времени;
  • date – дата проверки позиций;

Получить данные динамики проекта XXX в ПС Яндекс в регионе Санкт-Петербург за период
с 25 июля 2016 по 4 августа 2016 года:

https://api.topvisor.com/?api_key=Ваш_Ключ&oper=get&module=mod_keywords&func=history_summary
&post[project_id]=XXX&post[group_id]=-1&post[date1]=2016-07-25&post[date2]=2016-08-04&post[searcher]=0&post[region_key]=2