Что это
API Яндекс Вебмастера позволяет получать данные сервиса в собственный отчет или мониторинг. Вместо ручного открытия панели программа может читать список сайтов, диагностические сигналы и доступные сведения о поиске. Для данных конкретного сайта нужны права владельца или разрешенное делегирование.
API не заменяет краулер всего интернета и не является моделью, которая сама улучшает SEO. Он дает сигналы Яндекса. Проверку страниц, объяснение причин и приоритет исправлений готовит ваш процесс; отправка URL на переобход не обещает индексирования.
Начните с получения user_id и списка сайтов. Проверьте точный адрес, протокол и подтверждение прав, затем подключайте диагностику нужного сайта. Нельзя строить выводы по данным другого зеркала или считать отсутствие ответа отсутствием ошибок.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Дает структурированные данные Вебмастера для повторяемого мониторинга.
- Список hosts помогает проверить адрес сайта и его главное зеркало.
- Диагностика различает наличие проблемы, отсутствие и нехватку данных.
- Ресурсы запросов, индексирования и переобхода можно включить в собственный процесс.
Ограничения
- Нужны OAuth и подтвержденные права на сайт для соответствующих данных.
- Квоты, периоды, полнота выборки и расширенные возможности зависят от ресурса.
- Данные Вебмастера не равны мгновенному сканированию всех страниц.
- API не гарантирует рост позиций и не исправляет технические ошибки сайта сам.
Как использовать
1. Подготовка. Выберите собственный уже добавленный сайт в Вебмастере и проверьте права и главное зеркало. Запишите полный адрес с https; удаление сайтов и переобход для теста не нужны.
2. Настройка. Зарегистрируйте приложение в Яндекс OAuth по руководству Вебмастера и получите разрешенный токен. Официальная схема указывает webmaster:hostinfo и webmaster:verify; не используйте операции подтверждения без задачи. Храните токен на сервере. Для запросов задайте Authorization: OAuth <токен> и Accept: application/json.
3. Первый результат. Выполните GET https://api.webmaster.yandex.net/v4/user и возьмите user_id. Затем GET https://api.webmaster.yandex.net/v4/user/{user_id}/hosts. Прочитайте hosts и найдите свой сайт по адресу: сохраните host_id, verified и сведения main_mirror.
4. Проверка. Сверьте сайт и зеркало с панелью. host_id берите из ответа, не конструируйте из домена; при подстановке в путь кодируйте как сегмент URL. Для подтвержденного сайта прочитайте GET /v4/user/{user_id}/hosts/{host_id}/diagnostics и различайте PRESENT, ABSENT, UNDEFINED. При 401 проверьте токен, при INVALID_USER_ID - владельца; ошибки доступа не превращайте в отчет «проблем нет».
Примеры сценариев
- Проверить, что мониторинг читает HTTPS-зеркало.
- Вывести только присутствующие диагностические проблемы.
- Сравнить показатели одного периода без автоматических SEO-правок.
Доступ и оплата
- Модель оплаты: Не уточнено
- Работа в РФ: Да
- VPN: Не нужен
- Русский интерфейс: Да
- Русский язык: Не известно
Вебмастер имеет базовые и расширенные возможности. Например, выгрузка поисковых запросов отдельно учитывает базовую и расширенную квоту. Для каждого ресурса проверяйте доступ и лимит; не обещайте неограниченную выгрузку всех запросов. Хостинг обработчика и внешняя модель оплачиваются отдельно.
Когда не подходит
- Получать закрытую статистику конкурентов
- Гарантировать индексирование после запроса на переобход
- Считать выборку страниц полной копией индекса Яндекса
Альтернативы
Search Console API дает данные Google, а не Яндекса. DataForSEO API решает задачи внешних SEO-данных по своим условиям. Wordstat API показывает спрос, а не техническую диагностику вашего сайта.
