Снимки выдачи - анализ выдачи и конкурентов


Действие Параметры GET Параметры POST Ответ
Снимки выдачи &module=mod_snapshots project_id, searcher, region_key, region_lang, region_device, group_id, date1, date2, type_range, keywords_ids {all_dates, compare, is_empty, pos, scheme}
Динамика конкурирующих сайтов ТОПа &module=mod_snapshots&func=competitors project_id, searcher, region_key, region_lang, region_device, group_id, date, keywords_ids {all_dates, competitors, date, depth}

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

Обязательные параметры:
  • project_id – ID проекта;
  • searcher – описание значений здесь;
  • region_key – номер региона (номер региона общей выдачи "-1", сравнение по регионам "-2");
  • date – ID дата (международный формат YYYY-MM-DD);
  • region_lang – язык (по умолчанию ru);
  • type_range – описание значений здесь;
      Обратите внимание, что если для сравнения выбрано 2 и более запросов, то значение type_range может быть равно только 3 (две даты).
  • keywords_ids – массив id ключевых слов;

  • Необязательные параметры:
  • group_id – ID группы запросов (по умолчанию "-1" – все группы);
  • region_device – описание значений здесь (по умолчанию "0" - ПК);

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

  • all_dates – даты проверок;
  • pos – значения колонок;
  • scheme – имена колонок;
  • competitors – информация о конкурентах;
  • date – дата проверки;
  • depth – глубина проверки;

Получить снимки выдачи запроса id YYY в период с 20 апреля 2017 г. по 5 мая 2017 г. в ПС Яндекс в регионе Москва:
https://api.topvisor.ru/?api_key=Ваш_Ключ&module=mod_snapshots
&post[project_id]=XXX&post[searcher]=0;&post[region_key]=213&post[[group_id]=X&post[date1]=2017-04-20
&post[date2]=2017-05-05&post[type_range]=2&post[keywords_ids][]=YYY

Получить снимки выдачи запросов id YYY1 и id YYY2 за 20 апреля 2017 г. в ПС Яндекс в регионе Москва:
https://api.topvisor.ru/?api_key=Ваш_Ключ&module=mod_snapshots
&post[project_id]=XXX&post[searcher]=0;&post[region_key]=213&post[[group_id]=X&post[date1]=2017-04-20
&post[date2]=2017-04-20&post[type_range]=3&post[keywords_ids][]=YYY1&post[keywords_ids][]=YYY2

Получить информацию о конкурирующих сайтах ТОПа за 20 апреля 2017 г. в ПС Яндекс в регионе Москва:
https://api.topvisor.ru/?api_key=Ваш_Ключ&module=mod_snapshots&func=competitors
&post[project_id]=XXX&post[searcher]=0;&post[region_key]=213&post[group_id]=X&post[date]=2017-04-20