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

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

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

Актуальная версия API для работы с проектами (создание, удаление, копирование и др.).
Эта версия перестанет поддерживаться 01.01.2019 года.


Действие Параметры GET Параметры POST Ответ
Получить список проектов &oper=get&module=mod_projects
&func=v2
search_str Массив объектов проектов
Создать проект &oper=add&module=mod_projects site, name, tags[] {result: id, message, error}
Удалить проект &oper=del&module=mod_projects id {result: 0/1, message, error}
Копировать проект &oper=add&module=mod_projects
&func=duplicate
project_id, copy_keywords, copy_history {result: 0/1, message, error}
Перенести проект в архив/Восстановить проект из архива &oper=edit&module=mod_projects id, on {result: 0/1, message, error}
Обновить данные о регистраторе домена

После обновления данных они будут доступны через метод "Получить список проектов"

Метод не работает с проектами, указывающими на определенную страницу сайта (например ролик youtube)
&oper=get&module=mod_projects
&func=registrator_data
project_id registrator_data

В ответе может вернуться параметр wait_time - в таком случае вызов метода неободимо повторить через некоторое время

Описание параметров POST (функции редактирования):

  • site – URL проекта;
  • name – название проекта;
  • tags[] – массив номеров тега (возможные номера: от 1 до 10)
  • id – ID проекта;
  • project_id – ID проекта;
  • copy_keywords – копирование ядра:
    • 0 - не копировать
    • 1 - копировать
  • copy_history – копирование истории проверок:
    • 0 - не копировать
    • 1 - копировать
  • on – перенос в архив/восстановление из архива:
    • -1 - перенести проект в архив
    • 0 - восстановить проект из архива

Описание ответа (получить список проектов):

  • id – id проекта;
  • date – дата создания проекта;
  • update – время последней проверки позиций;
  • status – статус проверки:
    • 0 - без статуса;
    • 1 - проект поставлен в очередь;
    • 2 - идет проверка позиций;
  • update – время последней проверки позиций;
  • update – время последней проверки позиций;
  • subdomains – учитываются ли поддомены при проверке позиций:
    • 0 - не учитываются;
    • 1 - учитываются;
  • on – расписание проверок:
    • 0 - по требованию;
    • 1 - по дням недели;
    • 2 - после апдейтов Яндекса;
    • 3 - один раз в месяц;
    • 4 - по дням месяца;
  • time_for_update – "|день|:час" при автоматической проверке;
  • wait_after_updates – часы до автоматической проверки после апдейта;
  • count_keywords – число активных запросов проекта;
  • price – стоимость проверки проекта;
  • email – e-mail владельца проекта;
  • history – история статистики проекта за 2 последних дня;
  • cy – тИЦ;
  • indexed_y – количество страницх, проиндексированных в Yandex;
  • indexed_g – количество страницх, проиндексированных в Google;
  • traffic_y – трафик Yandex;
  • traffic_g – трафик Google;
  • backlinks – количество обратных ссылок;
  • searchers – данные о добавленных ПС, краткая динамика по их поизциям по сравениню с предыдущей проверкой (массив объектов);
  • registrator_data – данные о регистраторе доменной зоны;
    • created – время регистрации (UTS);
    • paidtill – оплачено до (UTS);
    • registrar – наименование регистратора;
    • registrar_link – ссылка не регистратора;
    • registrar_price – стоимость домена;
    • axelname_price – предлагаемая стоимость от регистратора Axelname;
    Обратите внимание, что перед получением данных регистратора через этот метод сперва их нужно обновить, используя метод Обновить данные о регистраторе домена

Получение данных проекта с id XXX или по имени XXX:
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=get&module=mod_projects&func=v2&post[search_str]=XXX

Создать проект example.com с красной меткой:
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=add&module=mod_projects&post[site]=example.com
&post[name]=Название_проекта&post[tags][]=2

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

Копировать проект XXX с историей:
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=add&module=mod_projects&func=duplicate
&post[project_id]=XXX&post[copy_keywords]=1&post[copy_history]=1

Восстановить проект XXX из архива:
https://api.topvisor.com/?api_key=ВАШ_КЛЮЧ&oper=edit&module=mod_projects&post[id]=XXX&post[on]=0