Способы проверки позиций
Эта версия перестанет поддерживаться 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