Позиции

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