API Яндекс Вебмастера: какие данные можно выгружать автоматически

Интерфейс Яндекс Вебмастера удобен для работы с одним сайтом. Но если сайтов несколько, нужно строить регулярные отчёты или хранить историю дольше, чем показывает интерфейс, вручную выгружать таблицы утомительно. Для этого у Вебмастера есть API — программный интерфейс, через который данные можно получать скриптом и передавать в таблицы, дашборды или собственные системы.

Какие данные доступны

Набор методов со временем расширяется и меняется, поэтому сверяйтесь с документацией. Обычно через API можно получить:

• Список сайтов аккаунта и статус подтверждения прав
• Сводку по сайту: число страниц в поиске, ИКС, проблемы
• Статистику поисковых запросов: показы, клики, позиции
• Историю индексирования и примеры страниц
• Данные о файлах sitemap
• Отправку адресов на переобход и проверку их статуса
• Сообщения диагностики

Как получить доступ

API Вебмастера работает с авторизацией через OAuth Яндекса. Порядок в общих чертах:

1. Зарегистрировать приложение в сервисе OAuth Яндекса и выбрать права на доступ к Вебмастеру.
2. Получить токен для аккаунта, у которого есть права на нужные сайты.
3. Узнать идентификатор пользователя через соответствующий метод API.
4. Делать запросы к методам с токеном в заголовке.

Токен даёт доступ к данным аккаунта, поэтому храните его как пароль: не публикуйте в коде, не отправляйте в мессенджерах.

Где автоматизация полезна

Агентству или специалисту с несколькими сайтами. Один скрипт собирает показы, клики и проблемы по всем проектам в общую таблицу.

Для долгосрочной истории. Интерфейс показывает данные за ограниченный период. Ежедневная выгрузка в свою базу позволяет сравнивать годы.

Для контроля индексации. Скрипт ежедневно проверяет число страниц в поиске и шлёт уведомление при резком изменении.

Для переобхода. После публикации новых страниц сайт сам отправляет их адреса на переобход в пределах лимита.

Пример простого сценария

Компания с основным сайтом и несколькими сайтами филиалов хочет еженедельный отчёт. Скрипт по расписанию получает список сайтов, для каждого — клики и показы за неделю и важные запросы, складывает в таблицу Google Sheets, а дашборд в Looker Studio строит графики. Руководитель видит данные без входа в Вебмастер.

Что выгружать в первую очередь

Для большинства задач достаточно трёх наборов: клики и показы по дням, запросы с позициями за неделю и число страниц в поиске. Этого хватает, чтобы видеть тренды, замечать падения и готовить отчёты. Остальные методы подключайте, когда появится конкретный вопрос, на который они отвечают.

Ограничения

• Есть лимиты на число запросов, при превышении API отвечает ошибкой
• Данные по запросам такие же неполные, как в интерфейсе: редкие фразы скрыты
• Методы и версии API меняются, старые версии со временем отключаются
• Для работы нужен человек, умеющий писать и поддерживать скрипты

Готовые решения

Если программировать некому, посмотрите на готовые коннекторы для систем визуализации и SEO-сервисы, которые подключаются к Вебмастеру через API. Они делают то же самое без кода. Перед подключением сторонних сервисов оцените, каким компаниям вы передаёте доступ к данным сайта.

Связка с Search Console

Для полной картины поиска данные Вебмастера удобно объединять с данными Google Search Console, у которой тоже есть API. Одинаковая структура выгрузки — запрос, страница, показы, клики, позиция, дата — позволяет сравнивать видимость в двух поисковиках в одном отчёте.

С чего начать

Начните с одной задачи: например, ежедневной выгрузки кликов и показов по сайту в таблицу. Когда она стабильно работает, добавляйте следующие. Так автоматизация растёт вместе с реальными потребностями, а не превращается в сложную систему, которую никто не поддерживает.