Яндекс.Вебмастер API + SEO Semantic Lab — пошаговая работа с запросами, показами, кликами и средней позицией своего сайта в поиске Яндекса через встроенный модуль SEO Semantic Lab. Эта инструкция относится именно к встроенной API-интеграции во вкладке «Фразы», а не к отдельному веб-интерфейсу сервиса.
Для получения данных нужен доступ к своему сайту или счётчику и разрешённая авторизация соответствующего аккаунта. Данные чужого сайта без предоставленных прав не загружаются. Доступность источника, полнота статистики и набор полей зависят от аккаунта, периода и ограничений API.
Что получает SEO-специалист из Яндекс.Вебмастера
API Яндекс.Вебмастера даёт данные об эффективности своего сайта в поиске Яндекса. Из отчётов можно получить известные Яндексу поисковые запросы, число показов, кликов, среднюю позицию и срезы по устройствам, если они доступны для данного метода. Это фактическая поисковая аналитика, а не частотность Вордстата и не посещения из Метрики.
| Показатель или срез | Интерпретация | Как использовать |
|---|---|---|
| Показы | Отображения результата сайта в поиске по определённым условиям | Определить группы запросов с известной видимостью |
| Клики | Переходы из выдачи Яндекса | Искать запросы, по которым сайт уже получает аудиторию |
| Средняя позиция показа | Агрегированная позиция по показам, а не фиксированный живой TOP | Сравнивать тенденции с правильным периодом и устройством |
| Десктоп / Мобильные / Планшеты | Разные типы устройств и соответствующие выборки | Проверить, не смешали ли мобильную и десктопную статистику |
| Сортировка по показам / кликам | Способ отбора верхних запросов | Выявить высокий спрос или уже работающий трафик без подмены полного ядра |
Как получить доступ к API
Подготовьте Яндекс-аккаунт, имеющий доступ к сайту в Яндекс.Вебмастере. Сам сайт должен быть корректно добавлен в сервис и иметь подтверждённые права. Выбор домена важен: версии с www и без www, HTTP/HTTPS и отдельные хосты могут иметь разное состояние в консоли. Для работы API используется OAuth-авторизация пользователя.
Пошаговое подключение Яндекс.Вебмастера к SEO Semantic Lab
- Откройте «Фразы» → «Интеграции с API» → «Я.Вебмастер».
- Нажмите «Подключить аккаунт», выполните разрешённую авторизацию Яндекса.
- Выберите сайт из доступных: проверьте протокол, основной домен и контекст проекта.
- В поле «Устр.:» выберите Все, Десктоп, Моб.+планшеты, Мобильные или Планшеты; в «Сорт.:» — Показы либо Клики.
- Выберите верхний период и при необходимости параметры истории / snapshot.
- Для получения новых поисковых запросов нажмите «Популярные запросы API»; для обогащения уже импортированной семантики — «Обновить данные по моим фразам».
- Дождитесь завершения, обновите таблицу «Фразы» и сверьте запросы, период, устройства, источник, пустые значения и порядок отбора.
«Популярные запросы API» и «Мониторинг запросов»: не одно и то же
Это разные процессы и разные наборы данных. В SEO Semantic Lab кнопка «Популярные запросы API» обращается к методу популярных поисковых запросов; готовый CSV/XLSX «Мониторинг запросов 18 месяцев» импортируется через отдельный формат импорта. Нельзя считать, что нажатие API-кнопки автоматически загружает всю многомесячную историю мониторинга.
По официальной документации API «Популярные запросы» возвращает ограниченную выборку запросов (включая механизмы сортировки по показам или кликам). Это не полный список всех запросов сайта, не все URL выдачи и не весь поисковый спрос. При изменении периода и устройства состав выборки также может отличаться.
| Цель | Что выбрать | Почему |
|---|---|---|
| Найти дополнительные известные запросы своего сайта | «Популярные запросы API» | Отдельный API-отчёт для добавления фраз и их поисковых показателей |
| Подставить показы/клики к уже собранному ядру | «Обновить данные по моим фразам» | Не добавляет автоматически весь набор ранее отсутствующих фраз |
| Анализировать готовую выгрузку мониторинга | «Импорт CSV/XLSX» с соответствующим профилем | Локальный файл и API-метод имеют разные поля и горизонты |
| Понять, какие URL-лидеры объединяют запросы | Отдельный сбор SERP в «SERP+Позиции» | Статистика собственного сайта не содержит выдачу всех конкурентов |
Практические SEO-интенты и проработка посадочных
Есть показы по группе, но нет кликов
Не начинайте с механического добавления слова в текст. Проверьте соответствие страницы запросу, позиции, сниппету, типу устройства и оформлению выдачи. Для примера «аудит сайта самостоятельно» и «заказать SEO-аудит» требуют разных ответов и, возможно, разных типов страниц. Карту текущих страниц и риски каннибализации можно разобрать в реестре URL.
Сайт растёт в Яндексе, но конверсии не растут
Сопоставьте клики и показы из Вебмастера с визитами и целями Яндекс.Метрики. Это разные показатели: один клик не всегда равен одному визиту, а визит не равен заявке. Сравнивайте одинаковые даты и корректные источники.
Google и Яндекс дают разные URL по одному интенту
Сопоставьте данные Вебмастера с Google Search Console, отдельно проверьте актуальную выдачу обеих систем и только после этого меняйте целевые страницы. Один набор усреднённых позиций не является доказательством поисковой каннибализации.
FAQ и частые ошибки
Почему сайт отсутствует в списке?
Проверьте подтверждение сайта, права аккаунта, протокол и вариант домена. Авторизация в другом Яндекс-аккаунте может вернуть иной список сайтов.
Почему всего несколько сотен запросов, а в семантике десятки тысяч?
API «Популярные запросы» ограничивает выборку и отбирает запросы определённым порядком. Часть слов могла не получить показы или не входить в выбранный отчёт. Отсутствие запроса не означает, что он никогда не встречался в поиске.
Можно ли вместо этого использовать Wordstat?
Wordstat показывает статистику поискового спроса по своей методике, а Вебмастер — эффективность своего сайта. Это дополнительные, но не взаимозаменяемые источники.
Совпадают ли позиции Вебмастера с проверкой TOP-10?
Не обязательно: средняя позиция агрегирована за период и устройства, а точечная проверка SERP относится к конкретной выдаче на определённое время.
Источники: метод популярных запросов Яндекс.Вебмастера и OAuth-авторизация. Названия кнопок приведены по Source of Truth SEO Semantic Lab 1.0.0.36. Подтверждение работы авторизации в конкретной Windows-сборке остаётся отдельной проверкой.
