🔽 Как подключить Яндекс.Вебмастер API и вытащить популярные запросы
Если хотите автоматизировать работу с Яндекс.Вебмастером (получать данные по сайтам, запросам, ссылкам и т.д.) — вот пошаговый гайд.
Шаг 1. Создаём приложение
→ Заходим: https://oauth.yandex.ru/
→ Авторизуемся в нужном Яндекс-аккаунте.
→ Жмём «Создать приложение»
→ Выбираем доступы:
→→webmaster:verify (добавление сайтов и статус индексации)
→→webmaster:hostinfo (данные по внешним ссылкам)
🧐 В результате получаем ClientID — уникальный идентификатор приложения. Он нужен, чтобы Яндекс понимал, какая именно программа обращается к API.
Шаг 2. Берём токен
В ссылку:
https://oauth.yandex.ru/authorize?response_type=token&client_id=<Client_ID>
подставляем свой ClientID, который получили на прошлом шаге и открываем её в браузере.
После перехода появится ваш OAuth-токен — его нужно скопировать. Это и есть ваш «ключ доступа» к API, с которым Яндекс будет понимать, что запросы выполняете именно вы.
Проверяем, что всё работает. Для этого можно использовать Postman, но в примере ниже покажем, как сделать то же самое через PHP-код в Google Colab:
import requests
url = "https://api.webmaster.yandex.net/v4/user/"
headers = {"Authorization": "OAuth <ваш_токен>"}
response = requests.get(url, headers=headers)
print(response.json())Вместо <ваш_токен> нужно подставить свой OAuth-токен.
🧐 После выполнения кода API вернёт JSON-ответ с информацией о пользователе. Одним из полей там будет user_id — это уникальный идентификатор вашего Яндекс-аккаунта, который необходим для всех следующих запросов к Webmaster API.
Шаг 3. Получаем список сайтов
Аналогично шагу 2, запускаем следующий код в окне выполнения команд Google Colab:
import requests
token = "y0_xxxxxxxxxxxxxxxxx" # вставляем свой токен
user_id = "183234122" #вставляем user_id
url = f"https://api.webmaster.yandex.net/v4/user/{user_id}/hosts"
headers = {"Authorization": f"OAuth {token}"}
response = requests.get(url, headers=headers)
print(response.json())
После запуска кода API вернёт JSON со списком всех сайтов, подключённых к вашему аккаунту в Яндекс.Вебмастере.
У каждого ресурса там будет поле host_id. Оно выглядит как строка в формате:
https:site.ru:443
Шаг 4. Работаем с методами API
Полный список методов в официальном руководстве: https://yandex.com/dev/webmaster/doc/ru/concepts/migration-guide
Для примера возьмём метод получения популярных поисковых запросов, и выполним следующий код:
import requests
token = "y0_xxx" # вставляем токен
user_id = "183234122" #вставляем user_id
host_id = "https:example.ru:443" #вставляем host_id
url = f"https://api.webmaster.yandex.net/v4/user/{user_id}/hosts/{host_id}/search-queries/popular"
headers = {"Authorization": f"OAuth {token}"}
params = {
"order_by": "TOTAL_CLICKS",
"query_indicator": "AVG_SHOW_POSITION",
"device_type_indicator": "DESKTOP",
"date_from": "2025-09-01",
"date_to": "2025-09-12",
"offset": 0,
"limit": 500
}
r = requests.get(url, headers=headers, params=params, timeout=30)
print(r.json())
Метод позволяет получить ТОП-3000 популярных запросов — но за один запрос максимум 500, поэтому используем offset, чтобы забрать всё. Можно сортировать по показам или кликам, брать среднюю позицию показа или клика, фильтровать по устройствам (мобильные/десктоп) и задавать нужный временной диапазон.
ps.
Дальше достаточно обернуть этот алгоритм в скрипт (в помощь ИИ), добавить перебор с offset, чтобы выгружать все доступные поисковые запросы в свою бд, и настроить регулярный запуск через планировщик.
В итоге получится автоматизированный процесс, при котором данные подтягиваются регулярно, а отчёты и дашборды обновляются без ручного вмешательства.🚀
