Русский
English
PRO Топвизор
Мы регулярно обновляем API Топвизора: добавляем методы для новых инструментов и сервисов, обновляем уже доступные схемы, а также добавляем фичи и исправляем ошибки.
В этом разделе мы публикуем информацию об обновлениях API. Подробное руководство разработчика доступно в документации API.
Чтобы получать важные уведомления об изменениях API на почту, подпишитесь на рассылку о Новостях API в Настройках аккаунта.
Осень 2026
Добавлена возможность проверять позиции в Яндексе в SERP. Настраивается с помощью параметра region_alt при добавлении (add/positions_2/searchers_regions) и изменении (edit/positions_2/searchers_regions) региона.
Добавлена возможность фильтровать ответ метода get/positions_2/history по наличию SERP Features по запросу: параметр filter_by_serp_features.
Обновлены методы работы с кластеризацией:
- Метод add/keywords_2/claster/task заменен на edit/keywords_2/claster/checker/go. Параметры для метода не изменялись.
- Метод add/keywords_2/claster/taskChange заменен на edit/keywords_2/claster/checker/reclaster/go. Параметры для метода не изменялись.
- Метод get/keywords_2/claster/price заменен на get/keywords_2/claster/checker/price. Добавлен обязательный параметр count. В возвращаемых данных стоимость теперь приходит в объекте pricesByUsers.
- Метод get/keywords_2/claster/priceChange заменен на get/keywords_2/claster/checker/reclaster/price. Добавлен обязательный параметр count. В возвращаемых данных стоимость теперь приходит в объекте pricesByUsers.
Внесены изменения в работу с настройками бренда в ИИ‑трекере:
- Параметры brand_name и brand_description в методах edit/aiTracker_2/settings и get/aiTracker_2/settings больше не используются. Для изменения настроек бренда проекта теперь используется метод edit/projects_2/brand, а для изменения настроек бренда конкурентов — edit/projects_2/competitors/brand.
- Получить поля настроек бренда можно методом get/projects_2/projects, добавив значения brand_name, brand_aliases, brand_description в параметр fields.
Лето 2026
Добавлены методы для работы ИИ‑Трекером, сервис aitracker‑2.
Обновлены методы по работе с конкурентами, добавлены параметры для работы с конкурентами в ИИ‑трекере.
В объекте типа Schedule.Time значения необходимо передавать только строкой. Используется в методах настройки и получения расписания проверок.
Для метода get/positions_2/history в ответе при использовании параметра show_top_by_depth в запросе раньше ответ приходил в параметре tops, теперь — topsByDepth. Также изменилась структура ответа: раньше данные приходили в формате определитель => процент, теперь — глубина => определитель => процент.
В объекте Проект изменилось название поля для получения статуса Проверки позиций с positions_percent на status_positions_percent.
Весна 2026
При получении статусов проектов через метод get/projects_2/projects (status_positions, status_relevants и т.д.) у ответа изменился тип с int на string.
Зима 2026
Для метода edit/keywords_2/volumes/go добавлены параметры для массового запуска по ПС: check_all_regions_yandex_types и check_all_regions_google. Также используется в методе get/keywords_2/volumes/price для получения цены такой проверки.
Осень 2025
Для метода get/projects_2/projects параметр include_positions_summary_params заменен на include_positions_summary.
Для объекта Проект поле site заменено на url.
Для метода add/keywords_2/groups параметр name заменен на names.