Поисковые системы

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

Действие Параметры GET Параметры POST Ответ
Добавить ПС и регионы &oper=add&module=mod_projects&func=searcher project_id,searcher,regions[] {{result: id, project_id, searcher, enabled, ord, name, regions[]}, message, error}
Удалить ПС &oper=del&module=mod_projects&func=searcher id По умолчанию
Добавить регион в ПС &oper=add&module=mod_projects&func=searcher_region searcher_id,
region
{{result: id, depth, device, key, lang, name}, message, error}
Удалить регион &oper=del&module=mod_projects&func=searcher_region id По умолчанию

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

  • project_id – ID проекта;
  • searcher – поисковая система:
    • 0 - Yandex
    • 1 - Google
    • 2 - Mail.ru
    • 4 - Youtube
    • 5 - Bing
    • 6 -Yahoo
    • 20 - Yandex.com
    • 21 -Yandex.com.tr
  • regions[] – код региона:глубина проверки:язык (для глубины проверки значение 1 соответствует глубине 100, 2 - 200 и т.д.)
  • id, searcher_id – ID поисковой системы (или региона);

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

  • result – результат выполнения запроса:
    • 0 - запрос не выполнен из-за ошибки;
    • 1 - запрос успешно выполнен;
  • message – сообщение об ошибке в формате Unicode Entities;
  • error – статус ошибки:
    • true -ошибкаесть
    • false - ошибки нет
  • id – id региона (поисковой системы);
  • ord – порядок следования поисковых систем в настройках проекта;
  • name – название региона;
  • depth – глубина проверки;
  • device – типустройства:
    • 0 - ПК
    • 1 - планшет
    • 2 - смартфон
  • lang – язык выдачи;
  • key – код региона;

Добавить ПС Yandex с регионами Москва и Санкт-Петербург в проект XXX:
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=add&module=mod_projects&func=searcher&post[id]=0
&post[project_id]=XXX&post[searcher]=0&post[regions][]=213:1:ru&post[regions][]=2:1:ru

Удалить ПС с номером YYY (id_searcher):
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=del&module=mod_projects&func=searcher&post[id]=YYY

Добавить ПС Yandex в проект XXX:
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=edit&module=mod_projects&func=searcher
&post[searcher]=0 &post[project_id]=XXX

Добавить регион Москва в ПС с номером YYY (id_searcher):
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=add&module=mod_projects&func=searcher_region
&post[searcher_id]=YYY &post[region]=213

Удалить регион XXX:
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=del&module=mod_projects&func=searcher_region
&post[id]=XXX