API Google Search Console: выгрузка запросов и страниц без ограничений интерфейса

Отчёт об эффективности в Google Search Console удобен для быстрого взгляда, но у интерфейса есть ограничения: таблица показывает ограниченное число строк, сложные срезы приходится собирать вручную, а данные хранятся ограниченный срок. API Search Console снимает часть этих ограничений и позволяет автоматически забирать данные в таблицы, базы и дашборды.

Что доступно через API

• Поисковая аналитика: клики, показы, CTR и позиция с разбивкой по запросам, страницам, странам, устройствам, датам и типам поиска
• Проверка URL: статус индексации конкретного адреса, тот же набор сведений, что и в инструменте проверки в интерфейсе
• Файлы sitemap: список отправленных карт, их статус, отправка новых
• Список ресурсов, к которым у аккаунта есть доступ

Отчётов об индексировании страниц в целом, Core Web Vitals и ссылок в API в полном виде нет — их по-прежнему смотрят в интерфейсе.

Чем API лучше интерфейса для аналитики

Главное преимущество — объём и гибкость выборки. Через API можно запрашивать данные с комбинацией нескольких измерений, например запрос и страница одновременно, и забирать их порциями по много тысяч строк за запрос, листая результаты. В интерфейсе такой срез получить сложно. Кроме того, ежедневная выгрузка в собственное хранилище позволяет хранить историю дольше, чем доступно в Search Console.

Ограничения, о которых нужно знать

• Редкие запросы скрываются ради конфиденциальности, поэтому сумма кликов по запросам меньше общего числа кликов
• Есть квоты на число запросов к API в единицу времени и в сутки
• Свежие данные появляются с задержкой и могут уточняться
• Позиция — усреднённое значение, а не точное место в выдаче

API даёт те же данные, что и Search Console, только удобнее. Если в интерфейсе запроса нет из-за анонимизации, через API он тоже не появится.

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

1. Создать проект в Google Cloud Console и включить в нём API Search Console.
2. Создать учётные данные: OAuth-клиент для работы от имени пользователя или сервисный аккаунт для автоматических скриптов.
3. Если используется сервисный аккаунт — добавить его адрес как пользователя в нужный ресурс Search Console.
4. Использовать официальные клиентские библиотеки, например для Python или JavaScript, и выполнять запросы.

Ключи и файлы учётных данных храните в защищённом месте и не публикуйте в репозиториях.

Готовые варианты без программирования

Если писать код некому, есть промежуточные решения. Looker Studio имеет встроенный коннектор к Search Console и строит отчёты без кода. Расширения для Google Таблиц умеют выгружать данные по API в таблицу. Многие SEO-платформы и краулеры подключаются к Search Console и показывают данные рядом с результатами сканирования.

Полезные сценарии

Еженедельный отчёт по группам страниц. Скрипт выгружает клики по страницам, группирует их по разделам — услуги, блог, каталог — и записывает в таблицу. Руководитель видит, какие разделы растут.

Поиск каннибализации. Выгрузка пар «запрос — страница» показывает запросы, по которым показываются две и более страниц сайта.

Поиск точек роста. Запросы с большим числом показов на позициях с пятой по пятнадцатую — кандидаты на усиление страниц.

Массовая проверка индексации. Через метод проверки URL можно проверять статус важных страниц, соблюдая дневную квоту.

Indexing API — это другое

Иногда путают API Search Console с Indexing API. Indexing API позволяет уведомлять Google о новых и удалённых страницах, но официально предназначен только для страниц с вакансиями и прямыми трансляциями. Использовать его для обычных страниц Google не рекомендует.

С чего начать

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