Google Search Console API для вашего стека
Данные о показах и кликах из Search Console через обычный REST-эндпоинт.
Забирайте клики, показы, CTR и среднюю позицию — по запросу, странице и диапазону дат — прямо из Google Search Console в свой продукт, дашборд или хранилище. Подключите GSC один раз в SEOcrawl AI, выпустите Bearer-ключ в панели и дёргайте REST /v1 — без самодельного Google OAuth. Это тот же канонический слой данных, на котором работает MCP SEOcrawl AI, так что цифры всегда сходятся. Покрытие индексации и инспекция URL появятся в REST следующими; через MCP они уже доступны.
Найдите ресурс. Забирайте данные GSC.
Выпустите Bearer-токен в панели и передавайте его в заголовке Authorization. Один раз узнайте id ресурса Search Console, дальше читайте его показатели через REST. Один и тот же ключ работает и в REST API, и на сервере MCP.
Базовый URL
https://api.seocrawl.ai/v1Заголовок Authorization
Authorization: Bearer sca_live_your_token_hereВсе метрики Search Console через REST
Клики, показы, CTR и средняя позиция — по запросу, странице, диапазону дат и в сравнении с предыдущим периодом. Каждый эндпоинт привязан к ресурсу: сначала узнайте его id, потом читайте данные Search Console. Эти группы GSC уже работают в v1; покрытие индексации и инспекция URL сегодня есть в MCP, а в REST появятся следующими.
Ресурсы
Список ресурсов Search Console, подключённых к вашему аккаунту. id ресурса подставляется в путь каждого эндпоинта GSC.
- GET
/v1/propertiesРаботает
Показатели
Общие клики, показы, CTR и средняя позиция за период — плюс разница с предыдущим периодом для того же окна.
- GET
/v1/properties/{id}/gsc/summaryРаботает - GET
/v1/properties/{id}/gsc/compareРаботает
Запросы
Поисковые запросы, по которым вы ранжируетесь, с метриками по каждому — и полная история любого ключевого слова по дням.
- GET
/v1/properties/{id}/gsc/top-keywordsРаботает - GET
/v1/properties/{id}/gsc/keywords/detailРаботает
Страницы
Самые результативные URL с метриками Search Console — и полная раскладка по дням для любой страницы.
- GET
/v1/properties/{id}/gsc/top-pagesРаботает - GET
/v1/properties/{id}/gsc/pages/detailРаботает
Покрытие индексации
Что Google действительно индексирует: статусы покрытия и история индексации. Сегодня доступно в MCP; REST-эндпоинты в работе.
- GET
/v1/properties/{id}/indexation/summaryСкоро
Инспекция URL
Проверка отдельного URL — покрытие, последний обход и статус индексации одной страницы. Уже доступна через MCP; REST следующий.
- GET
/v1/properties/{id}/url-inspectionСкоро
Настоящие данные Search Console — под продукт
Ваши реальные показатели в Google Search Console, а не сторонние оценки, через нормальный REST API с аутентификацией Bearer и понятными лимитами. Слой данных общий с MCP, поэтому цифры не расходятся.
Напрямую из Search Console
Клики, показы, CTR и средняя позиция берутся из вашего собственного ресурса GSC — это настоящие цифры Google, а не смоделированные или спарсенные оценки. Предсказуемые ресурсы, стандартные методы, типизированный JSON и ошибки по RFC.
Без своего Google OAuth
Подключите Search Console один раз в SEOcrawl AI и дальше читайте её одним Bearer-ключом sca_live_. Проект в Google Cloud, экран согласия и обновление токенов не нужны — ключи выпускаются и отзываются в панели за секунды.
Один канонический слой данных
REST-эндпоинты GSC и инструменты GSC в MCP — близнецы поверх одного провайдера, паритет проверяется в CI. Ваш дашборд и ваши AI-агенты всегда видят одни и те же клики, показы и позиции.
Детализация по запросу и странице
Читайте сводку по всему ресурсу или копайте глубже: топ запросов, топ страниц, динамика одного ключевого слова по дням, история одного URL. Те же срезы, что вы видите в Search Console, только по HTTP.
Сравнение периодов из коробки
Запросите диапазон (last_7_days, last_28_days, last_3_months, last_year) или явные даты from/to — сравнение с предыдущим периодом придёт сразу, без второго вызова и без подсчёта дат на клиенте.
Задокументированные лимиты
60 запросов в минуту и 1 000 в час на токен, с понятным ответом 429 и заголовком Retry-After. Лимиты REST считаются отдельно от MCP: одно никогда не съедает другое.
Старт в 3 шага
От нуля до первого вызова Search Console — пара минут.
Выпустите ключ
Подключите Search Console в SEOcrawl AI, откройте токены API и выпустите Bearer-токен. Скопируйте его сразу — он начинается с sca_live_.
Найдите ресурс
Вызовите GET /v1/properties с заголовком Authorization: Bearer sca_live_… и возьмите id (UUID) того ресурса Search Console, который хотите читать.
Забирайте данные GSC
Дёрните /v1/properties/{id}/gsc/summary?range=last_28_days для сводки или /gsc/top-keywords, /gsc/top-pages и эндпоинты /detail — и отправляйте JSON прямо в продукт, дашборд или хранилище.
Три способа добраться до данных Search Console
Цифры GSC одни и те же, поверхности разные — берите ту, которая подходит вашему стеку.
REST API
Для продуктов, дашбордов и пайплайнов данных. Аутентификация Bearer, типизированный JSON, лимиты запросов. Вы на этой странице — полное SEO API добавляет по тому же ключу эндпоинты позиций и видимости в AI.
MCP-сервер
Для AI-агентов: Claude, ChatGPT и любой MCP-клиент спрашивают ваши данные Search Console обычным языком.
Изучить MCPТерминал и CLI
Для скриптов и CI/CD: работайте с данными GSC из любого терминального агента с поддержкой MCP.
Посмотреть CLIКто строит на Search Console API
Команды, которым нужны настоящие показатели GSC внутри своих систем.
Агентства
Отправляйте данные Search Console каждого клиента в свой портал, Looker Studio или собственный слой отчётности — один ключ, все ресурсы, без ручных выгрузок из GSC.
SaaS и партнёры
Встройте живые метрики Search Console в интерфейс своего продукта. Отдавайте пользователям клики, показы и позиции, не подключая API Google самостоятельно.
Команды данных
Заливайте клики, показы, CTR и позицию из GSC в хранилище по расписанию. Джойните с выручкой и стройте модели, на которых держатся ваши дашборды.
Разработчики
Автоматизируйте мониторинг запросов и страниц, шлите алерты о падении позиций и встраивайте данные Search Console в приложения и процессы, которые вы и так релизите.
Частые вопросы
Это официальное Search Console API от Google?
Нет. Это собственный REST API SEOcrawl AI с аутентификацией Bearer поверх данных Search Console, которые вы уже подключили к своему аккаунту. Вы подключаете GSC один раз в SEOcrawl AI, а дальше читаете клики, показы, CTR и позицию по одному ключу sca_live_ — без своего проекта в Google Cloud, экрана согласия OAuth и обновления токенов. Цифры — ваши настоящие цифры Search Console; API и аутентификация — наши.
Какие данные Search Console доступны сегодня?
Сводка за период (клики, показы, CTR, средняя позиция), сравнение периодов, топ запросов и страниц с метриками, полная детализация по дням для одного ключевого слова или одной страницы — плюс список подключённых ресурсов. Покрытие индексации и инспекция URL уже доступны через MCP; их REST-эндпоинты появятся следующими. А если вам проще прочитать аккаунт, чем запрашивать его, аудит Google Search Console покрывает те же данные одним промптом.
Как аутентифицироваться?
Bearer-токеном. Выпустите ключ sca_live_ в панели и отправляйте его как Authorization: Bearer <key> в каждом запросе. Для своего аккаунта никаких плясок с OAuth — только заголовок.
Какие диапазоны дат поддерживаются?
Любой эндпоинт GSC принимает либо range (last_7_days, last_28_days, last_3_months или last_year), либо явную пару from/to. Эндпоинт gsc/compare возвращает то же окно в сравнении с предыдущим периодом, так что разницу вы получаете без второго вызова.
Какие лимиты запросов?
60 запросов в минуту и 1 000 в час на токен. Превысите — придёт 429 с заголовком Retry-After. Лимиты REST считаются отдельно от MCP, так что за один бюджет они не конкурируют.
Это тот же ключ и те же данные, что в MCP?
Да. Один и тот же токен sca_live_ аутентифицирует и REST API, и MCP-сервер, и оба читают один канонический слой данных — так что цифры Search Console из REST совпадают с тем, что видят ваши AI-агенты через MCP. Одни доступы, две поверхности.
Готовы строить на своих данных Search Console?
Подключите GSC один раз, выпустите Bearer-ключ в панели и сделайте первый REST-вызов к Search Console за пару минут — или изучите MCP для AI-агентов.
