Измените языковые настройки Топвизор для работы с сервисом на родном языке. Вы также сможете выбрать и установить язык интерфейса позже в настройках Аккаунта. Измените языковые настройки Топвизор для работы с сервисом на родном языке. 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
    • 3 - Спутник
    • 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