Частота запросов

Актуальная версия API для получения результатов проверки частоты.
Актуальная версия API для получения статуса проверки частоты в проекте.
Актуальная версия API для получения стоимости проверки частоты.
Актуальная версия API для запуска проверки частоты.

Эта версия перестанет поддерживаться 01.08.2021 года.

Действие	Параметры GET	Параметры POST	Ответ
Проверка частоты запросов	&oper=edit&module=mod_keywords &func=frequency_task	project_id, group_id, only_new, provider, regions_keys, phrase_forms, currency	По умолчанию
Посмотреть результат проверки частоты	&oper=get&module=mod_keywords	project_id, searcher, region_key, group_id	{phrase_id, group_id, ord, target, tag, group_name, phrase, target_status, frequency, price}
Стоимость проверки частоты	&oper=get&module=mod_keywords &func=frequency_price	project_id, group_id, only_new, phrase_forms, provider, regions_keys	[NN.NN]
Статус проверки частоты	&oper=get&module=mod_keywords &func=frequency_status	project_id	[true] - частота проверяется, [false] - частота не проверяется

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

id, project_id – ID проекта;
only_new – проверенная частота:
- 0 - не пропускать проверенную частоту
- 1 - пропустить проверенную частоту
provider – выбранный источник:
- 0 - Яндекс.Директ;
- 1 - Google Ads;
- 2 - Webmaster Mail.ru
region_keys – код региона (-1 - Без региона);
phrase_forms – тип частоты:
- 1 - Частота
- 2 - "Частота" (тип Частота для источника Webmaster Mail.ru)
- 3 - "!Частота" + Стоимость (тип [Частота] + Стоимость для источника Google Ads)
- 5 - "[Частота]"
- 6 - "[!Частота]"
currency – валюта цены клика (по умолчанию - валюта аккаунта):
- RUB - российский рубль;
- USD - доллар США;

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

result – количество отправленных задач;
message – сообщение об ошибке в формате Unicode Entities;
error – статус ошибки:
- true - ошибка есть
- false - ошибки нет
phrase_id – ID фразы;
ord – подрядок запроса в группе;
target – целевая ссылка;
tag – цветовая метка;
group_name – название группы;
phrase – поиковый запрос;
target_status – статус целевой ссылки:
- 0 - целевая ссылка не совпадает с релевантной
- 1 - целевая ссылка совпадает с релевантной
- -1 - целевая ссылка в выдаче не найдена
- -2 - целевая ссылка не установлена
frequency – тип частоты:
- frequency1 - Частота
- frequency2 - "Частота" (тип Частота для источника Webmaster Mail.ru)
- frequency3 - "!Частота" + Стоимость (тип [Частота] + Стоимость для источника Google Ads)
- frequency5 - "[Частота]"
- frequency6 - "[!Частота]"
price – цена за клик:
- price1 - 1-ое спецразмещение
- price2 - 2-ое спецразмещение
- price3 - спецразмещение
- price4 - 1 место
- price5 - гарантия

Отправить на проверку запросы проекта XXX группы YYY по Санкт-Петербургу и Москве всех типов
частоты в Яндекс и точного типа в Google, повторно проверенную частоту в этом месяце
не проверять:
https://api.topvisor.com/?api_key=Ваш_Ключ&oper=edit&module=mod_keywords&func=frequency_task
&post[project_id]=XXX
&post[providers][0][provider]=0
&post[providers][0][regions_keys][]=2
&post[providers][0][regions_keys][]=213
&post[providers][0][phrase_forms][]=1
&post[providers][0][phrase_forms][]=2
&post[providers][0][phrase_forms][]=3
&post[providers][0][phrase_forms][]=5
&post[providers][0][phrase_forms][]=6
&post[providers][1][provider]=1
&post[providers][1][regions_keys][]=2
&post[providers][1][regions_keys][]=213
&post[providers][1][phrase_forms][]=3
&post[filters][0][name]=id&post[filters][0][operator]=IN&post[filters][0][values][0]=YYY
&post[only_new]=1

Получить результат проверки частоты проекта XXX по региону Санкт-Петербург в Яндекс:
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=get&module=mod_keywords&post[project_id]=XXX
&post[region_key]=2&post[searcher]=0