Измените язык, если вам нужно работать с Топвизором на другом языке. Язык интерфейса можно изменить в любое время в настройках аккаунта. Измените язык, если вам нужно работать с Топвизором на другом языке. ru Русский Выбрать

Способы проверки позиций

Актуальная версия API для проверки позиций.
Эта версия перестанет поддерживаться 01.05.2018 года.
Действие Параметры GET Параметры POST Ответ
Проверка позиций по всему ядру запросов &oper=edit&module=mod_keywords
&func=parse_task
id {result, message, error}
Проверка позиций с учётом фильтра &oper=edit&module=mod_keywords
&func=parse_task
id, searcher, region_key, region_lang, group_id, region_device {result, message, error}
Выборочная проверка позиций &oper=edit&module=mod_keywords
&func=parse_one_task
phrase_id, project_id, searcher, region_key, region_lang, region_device, id {result, message, error}

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

  • id – ID проекта;
  • searcher – выбранная ПС:
    • 0 - Yandex, домен определяется по региону;
    • 1 - Google, домен определяется по региону;
    • 2 - Mail.ru
    • 4 - Youtube
    • 5 - Bing
    • 6 - Yahoo
    • -2 - Cравнение по поисковикам
  • region_key – номер региона (номер региона общей выдачи "-1", сравнение по регионам "-2");
  • region_lang – язык (по умолчанию ru);
  • group_id – ID группы запросов ("-1" – все группы);
  • region_device – тип устройства:
    • 0 - ПК
    • 1 - планшет
    • 2 - смартфон
  • phrase_id – ID фразы;
  • project_id – ID проекта;

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

  • result – статус проверки:
    • 0 - проверка позиций не началась из-за ошибки;
    • 1 - проверка позиций началась;
  • message – сообщение об ошибке в формате Unicode Entities;
  • error – статус ошибки:
    • true - ошибка есть
    • false - ошибки нет

Запустить проверку позиций проекта XXX по всему ядру запросов:
https://api.topvisor.com/?api_key=Ваш_Ключ&oper=edit&module=mod_keywords&func=parse_task
&post[id]=XXX

Запустить проверку позиций запросов группы X проекта XXX в ПС Яндекс
в регионе Санкт-Петербург:

https://api.topvisor.com/?api_key=Ваш_Ключ&oper=edit&module=mod_keywords&func=parse_task
&post[id]=XXX&post[searcher]=0&post[region_key]=2&post[region_lang]=ru&post[region_device]=0
&post[group_id]=X

Запустить проверку позиции запроса X проекта XXX в ПС Яндекс в регионе Санкт-Петербург:
https://api.topvisor.com/?api_key=Ваш_Ключ&oper=edit&module=mod_keywords&func=parse_one_task
&post[project_id]=XXX&post[searcher]=0&post[region_key]=2&post[region_lang]=ru&post[region_device]=0
&post[phrase_id]=X&post[id]=XXX