Подключение Топвизора
Топвизор — одна из самых популярных систем съёма позиций. Позиции снимает сам Топвизор, а наш сервис по API забирает уже готовые данные и выводит их в отчёте — с динамикой по ключевым фразам, поисковым системам и регионам.
Где взять API-ключ
Для подключения нужны ID пользователя и API-ключ из Топвизора. Оба значения есть на странице настроек аккаунта Топвизора — topvisor.com/account: ID профиля указан в самом верху страницы, API-ключ — в самом низу.
Скопируйте оба значения — они понадобятся на следующем шаге. Никому не передавайте API-ключ: он открывает чтение данных вашего аккаунта в Топвизоре.

Подключение по шагам
Откройте раздел «Источники данных» и нажмите «Подключить» — появится список «Выберите систему для подключения».
- В списке выберите систему Топвизор — откроется окно «Подключение Топвизор».
- Заполните поля: «Название источника» — понятное вам имя, чтобы отличать источник в списке, «User ID в Топвизор» и «API-ключ».
- Нажмите «Подключить» — сервис проверит ключ, и источник появится в списке подключённых.

Как попадает в отчёт
Данные по позициям не появляются в отчёте сами по себе — нужны две вещи:
- Убедитесь, что в структуре шаблона включены блоки, связанные с позициями: «Позиции в поисковых системах», «Общая статистика по позициям», «Динамика по средней позиции».
- При генерации отчёта в блоке «Позиции в поисковых системах» в поле «Включить данные по позициям» выберите проект Топвизора.
- Отметьте поисковые системы и регионы, по которым нужно загрузить данные.
Даты снятия позиций
По умолчанию система берёт последнее снятие в отчётном периоде и последнее снятие в периоде сравнения. Если нужны конкретные даты, их можно задать вручную — там же, после выбора проекта:
- «Дата снятия за отчетный период» — какое снятие показать как текущее.
- «Дата предыдущего снятия» — снятие за период сравнения.
- «Дата первого снятия» — снятие на дату начала продвижения, от него считается общая динамика.
Фильтры, сортировка и выгрузка ядра
В тех же настройках можно ограничить, что попадёт в таблицу: настроить фильтры «По ТОП» и «По динамике», а также сортировку.
А полное ядро удобно отдать файлом: отметьте «Включить в отчет ссылки на экспорт позиций в xls» — так настройка называется в интерфейсе. В отчёт добавится ссылка, по которой скачивается XLSX-файл с ключевыми фразами и снятиями за выбранные даты. Подробнее — в статье про экспорт отчёта.