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

Актуальная версия 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