Измените язык, если вам нужно работать с Топвизором на другом языке. Язык интерфейса можно изменить в любое время в настройках аккаунта. Измените язык, если вам нужно работать с Топвизором на другом языке. ru Русский Выбрать

Конкуренты (устаревшая версия)

Актуальная версия API для настройки конкурентов проекта.
Эта версия перестанет поддерживаться 01.01.2019 года.

Действие Параметры GET Параметры POST Ответ
Добавить конкурента &oper=add&module=mod_projects&func=competitor project_id, competitors_sites {[result: id, site, name, on], message, error}
Удалить конкурента &oper=del&module=mod_projects&func=competitor id {result, message, error}
Включить/выключить конкурента &oper=edit&module=mod_projects main_project_id, id, on {result, message, error}
Переименовать конкурента &oper=edit&module=mod_projects main_project_id, id, name {result, message, error}

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

  • project_id – id проекта;
  • competitors_sites – URL сайта-конкурента;
  • id – id конкурента;
  • main_project_id – id проекта;
  • on – включение/выключение конкурента:
    • 0 - включить конкурента
    • -1 - выключить конкурента
  • name – имя конкурента;

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

  • result – результат выполнения запроса:
    • 0 - запрос не выполнен из-за ошибки;
    • 1 - запрос успешно выполнен;
  • message – сообщение об ошибке в формате Unicode Entities;
  • error – статус ошибки:
    • true - ошибка есть
    • false - ошибки нет
  • id – id конкурента;
  • site – URL конкурента;
  • name – имя конкурента;

Добавить конкурента example.com в проект XXX:
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=add&module=mod_projects&func=competitor
&post[project_id]=XXX&post[competitors_sites]=example.com

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

Выключить конкурента X в проекте XXX:
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=edit&module=mod_projects&post[main_project_id]=XXX
&post[id]=X&post[on]=-1