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

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

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

Действие Параметры 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