Зачем бизнесу Google Search Console API
Интерфейс Search Console хорош для быстрого взгляда: открыли отчёт, увидели динамику. Но как только сайт вырос, начинаются неудобства. Таблица показывает ограниченное число строк, сложные срезы приходится собирать руками, а история хранится не бесконечно. Если вы ведёте интернет-магазин в Ташкенте с тысячами карточек товаров или сайт клиники с десятками услуг, интерфейса быстро становится мало.
API решает именно эту задачу. Вы настраиваете выгрузку один раз, и данные сами попадают в Google Таблицу, базу данных или дашборд. Это те же цифры, что и в Search Console, но в удобной для анализа форме и с историей, которую вы храните сами.
Какие данные доступны через API
Через API доступны не все отчёты Search Console, а четыре группы данных.
- Поисковая аналитика: клики, показы, CTR и средняя позиция с разбивкой по запросам, страницам, странам, устройствам и датам.
- Проверка URL: статус индексации конкретного адреса, как в инструменте проверки в интерфейсе.
- Файлы sitemap: список отправленных карт, их статус, отправка новых.
- Список сайтов, к которым у аккаунта есть доступ.
Что остаётся только в интерфейсе
Общие отчёты об индексировании страниц, Core Web Vitals и ссылки в полном виде через API не получить. Их по-прежнему смотрят в самом Search Console. Поэтому API не заменяет интерфейс, а дополняет его там, где нужны объём и автоматизация.
Ограничения, которые стоит знать заранее
Первое: редкие запросы Google скрывает ради конфиденциальности. Из-за этого сумма кликов по запросам почти всегда меньше общего числа кликов по сайту. Если запрос не виден в интерфейсе, через API он тоже не появится.
Второе: есть квоты на количество обращений в единицу времени и в сутки, особенно это важно при массовой проверке URL. Третье: свежие данные приходят с задержкой и могут уточняться, поэтому не стоит принимать решения по вчерашнему дню. И четвёртое: позиция — это усреднённое значение, а не точное место в выдаче.
Как получить доступ к API
Порядок действий для технического специалиста выглядит так:
- Создать проект в Google Cloud Console и включить в нём API Search Console.
- Выбрать способ авторизации: OAuth-клиент, если скрипт работает от имени человека, или сервисный аккаунт для автоматических задач.
- Добавить адрес сервисного аккаунта пользователем в нужный сайт в Search Console.
- Подключить официальную клиентскую библиотеку, например для Python или JavaScript, и отправить первый запрос.
- Хранить ключи и файлы учётных данных в защищённом месте и не выкладывать их в репозитории.
Если программиста нет
Писать код необязательно. В Looker Studio есть встроенный коннектор к Search Console, с ним можно собрать дашборд без разработки. Расширения для Google Таблиц выгружают данные по API прямо в таблицу. Многие SEO-платформы и краулеры тоже подключаются к Search Console и показывают данные рядом с результатами сканирования сайта.
Для небольшого сайта услуг этого обычно достаточно. Собственный скрипт нужен, когда страниц много, проектов несколько или данные надо объединять с продажами из CRM, заявками из Telegram-бота и рекламой.
Практические сценарии и с чего начать
Самые полезные задачи, которые решает выгрузка: еженедельный отчёт по группам страниц (услуги, блог, каталог), поиск каннибализации по парам «запрос — страница», поиск запросов с большим числом показов на позициях примерно с пятой по пятнадцатую, а также регулярная проверка индексации важных страниц. Скрипт может даже написать в Telegram, если клики резко упали.
Не путайте этот API с Indexing API. Последний официально предназначен только для страниц с вакансиями и прямыми трансляциями, и для обычных страниц Google его использовать не рекомендует.
Начните с одной простой выгрузки: клики и показы по страницам за каждый день. Когда она стабильно работает, добавляйте разбивку по запросам и устройствам. Сохраняйте сырые данные, а не только готовые отчёты: через год они понадобятся для сравнения. Если хотите понять, какие данные Search Console стоит связать с продажами и как превратить их в маркетинговые решения, команда markdev поможет выстроить стратегию и аналитику под вашу задачу.
Частые вопросы
Google Search Console API платный?
Сам доступ к данным не требует отдельной оплаты, но нужен проект в Google Cloud и соблюдение квот. Условия лучше проверять в актуальной документации Google.
Чем API отличается от обычного отчёта в Search Console?
Данные те же, но через API можно комбинировать несколько измерений, забирать больше строк, автоматизировать выгрузку и хранить историю у себя.
Почему сумма кликов по запросам меньше общей?
Google скрывает редкие запросы ради конфиденциальности. Они учитываются в общей статистике, но не попадают в список запросов ни в интерфейсе, ни в API.
Нужен ли программист, чтобы использовать API?
Не всегда. Для базовых отчётов хватит коннектора Looker Studio или дополнения для Google Таблиц. Скрипты нужны для больших сайтов и сложной аналитики.
Разберём вашу задачу бесплатно
Оставьте контакт — за 15 минут созвона покажем, где теряются заявки и что сделать в первую очередь.