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 вони вже доступні.
Визначте property. Отримуйте дані GSC.
Згенеруйте токен Bearer у панелі та передайте його в заголовку Authorization. Один раз визначте id property Search Console, а потім запитуйте її продуктивність через REST. Той самий ключ працює і в REST API, і на сервері MCP.
Базовий URL
https://api.seocrawl.ai/v1Заголовок Authorization
Authorization: Bearer sca_live_your_token_hereУсі метрики Search Console, через REST
Кліки, покази, CTR і середня позиція — за запитом, сторінкою, діапазоном дат і період до періоду. Кожен ендпоінт прив’язаний до property: спершу визначте її id, а потім читайте дані Search Console. Ці групи GSC доступні наживо у v1; покриття індексації та інспекція URL сьогодні є в MCP, а в REST з’являться наступними.
Property
Отримайте список property Search Console, під’єднаних до вашого облікового запису. Використовуйте id кожної property у шляху кожного ендпоінта 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 і середня позиція, отримані з вашої власної property GSC — справжні числа, які повідомляє Google, а не змодельовані чи зіскрапані оцінки. Передбачувані ресурси, стандартні дієслова, типізований JSON і помилки згідно з RFC.
Без власного Google OAuth
Під’єднайте Search Console один раз у SEOcrawl AI, а потім читайте її одним ключем Bearer sca_live_. Пропустіть проєкт у Google Cloud, екран згоди та оновлення токенів — створюйте й відкликайте ключі в панелі за лічені секунди.
Один канонічний шар даних
REST-ендпоінти GSC та інструменти GSC в MCP — побратими над одним провайдером, із паритетом, що тестується в CI. Ваш дашборд і ваші AI-агенти завжди бачать однакові кліки, покази та позиції.
Деталізація за запитом і сторінкою
Читайте підсумки для всієї property або занурюйтеся глибше: найкращі запити, найкращі сторінки, щоденний тренд одного ключового слова чи історія одного 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_.
Визначте property
Викличте GET /v1/properties із Authorization: Bearer sca_live_…, щоб отримати id (UUID) тієї property 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 чи свій шар звітності — один ключ, усі property, без ручних експортів із 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, середня позиція), порівняння періодів, ваші найкращі запити та сторінки з метриками і повну щоденну деталізацію одного ключового слова чи однієї сторінки — плюс список ваших під’єднаних property. Покриття індексації та жива інспекція 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-агентів.
