Як користуватися Google Search Console API?

Q: Як користуватися Google Search Console API?

Створіть проєкт у Cloud, увімкніть API, авторизуйтеся через OAuth, а потім запитуйте дані про ефективність, перевірку URL і sitemap-файли. Ось кроки та квоти.

Створіть проєкт у консолі Google Cloud, увімкніть Google Search Console API, створіть облікові дані OAuth 2.0 і увійдіть в обліковий запис Google, який має доступ до ресурсу. Після цього можна надсилати запити до чотирьох ресурсів: Search Analytics (кліки, покази, CTR і позиція), URL Inspection (стан індексації), Sitemaps і Sites. Самих лише API-ключів недостатньо: кожен виклик потребує токена OAuth, а квоти обмежують обсяг даних, які можна запитати.

Що охоплює API, а що ні

Ресурс	Методи	Для чого використовувати
Search Analytics	`query`	Рядки з даними про ефективність за запитом, сторінкою, країною, пристроєм, виглядом у пошуку, датою або годиною
URL Inspection	`index.inspect`	Проіндексована версія одного URL: покриття, останнє сканування, канонічні адреси
Sitemaps	`list`, `get`, `submit`, `delete`	Керування sitemap-файлами, які надіслано для ресурсу
Sites	`list`, `get`, `add`, `delete`	Ресурси в поточному обліковому записі

Це весь API. Для посилань, статистики сканування, звіту «Індексування сторінок» і звіту Core Web Vitals кінцевих точок немає, тож вони доступні лише в інтерфейсі Search Console. URL Inspection показує, що є в індексі Google, а не результат живої перевірки сторінки.

Налаштування доступу

У консолі Google Cloud створіть проєкт або виберіть наявний.
Увімкніть Google Search Console API для цього проєкту.
Налаштуйте екран згоди OAuth і створіть ідентифікатор клієнта OAuth.
Запросіть область доступу: https://www.googleapis.com/auth/webmasters.readonly для читання або https://www.googleapis.com/auth/webmasters, якщо також потрібно додавати чи видаляти sitemap-файли.
Увійдіть в обліковий запис, який має дозвіл на ресурс. Для читання даних про ефективність потрібен принаймні доступ на читання; API бачить рівно те, що бачить цей обліковий запис.

Ваш перший запит до Search Analytics

POST https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "startDate": "2026-09-01",
  "endDate": "2026-09-30",
  "dimensions": ["query", "page"],
  "type": "web",
  "rowLimit": 25000,
  "startRow": 0
}

Сайт указують у шляху в закодованому вигляді (URL-encoded): sc-domain:example.com для ресурсу рівня домену або точний префікс із кінцевою скісною рискою, наприклад https://www.example.com/, для ресурсу з префіксом URL. Найважливіші поля:

Дати включно та за тихоокеанським часом.
type за замовчуванням має значення web; інші — image, video, news, googleNews і discover. Кожен тип потребує окремого запиту.
Фільтри задаються в dimensionFilterGroups з операторами від equals і contains до includingRegex та excludingRegex (синтаксис RE2).
rowLimit — від 1 до 25 000 (за замовчуванням 1 000); решту рядків можна отримати посторінково через startRow.
dataState за замовчуванням має значення final; all додає свіжі, ще не завершені дні, а hourly_all працює з виміром hour.

Кожен рядок містить keys, clicks, impressions, ctr (від 0 до 1) і position; сортування за кліками, якщо тільки не групувати за датою.

Обмеження, які впливають на ваш код

50 000 рядків на день для кожного типу пошуку. Отримуйте дані посторінково через startRow із кроком 25 000 і зупиняйтеся на порожній відповіді. Щоб отримати максимум, запитуйте по одному дню.
Квота навантаження. Найдорожчий запит — той, що групує або фільтрує одночасно за сторінкою та запитом, а довгі діапазони дат коштують більше, ніж короткі. Якщо перевищити короткострокову квоту, Google просить зачекати 15 хвилин.
Частота запитів. 1 200 запитів на хвилину на сайт і на користувача; 40 000 на хвилину та 30 000 000 на день на проєкт.
Квота URL Inspection. 2 000 перевірок на день і 600 на хвилину для кожного ресурсу.
Історія за 16 місяців, а дані зазвичай стають доступними через два-три дні після завершення доби.
Сума рядків не дорівнює підсумкам. Рідкісні запити не потрапляють до рядків на рівні запитів, а групування за сторінкою рахує покази інакше, ніж групування за ресурсом, тож підсумки варто брати із запиту без виміру «запит».

Типові помилки

Використання http://, коли ресурс має адресу https://, або пропущена кінцева скісна риска спричиняє помилку дозволу, навіть якщо обліковий запис має доступ.
У URL Inspection запит URL поза межами ресурсу відхиляється: URL має належати до siteUrl, який ви передаєте.
Місяць, згрупований за запитом і сторінкою в одному виклику, повертає лише найпопулярніші рядки. Щоденні запити повертають більше.

Як допомагає AutoPSEO

Якщо ви не хочете підтримувати OAuth і постійну пагінацію, AutoPSEO підключається через вхід Google і надає ті самі дані через власний REST API за адресою /v1 (з документом OpenAPI 3.1) та MCP-сервер, авторизація за допомогою API-ключа з розділу Account → API keys. Доступні ключі лише для читання, кінцева точка search analytics повертає до 5 000 рядків за виклик, а інструменти URL Inspection у застосунку самі ведуть облік квоти Google в 2 000 перевірок на день. Дивіться MCP та API-ключі. Щоб зберігати дані довше за 16 місяців без створення власного конвеєра, прочитайте, як довго Search Console зберігає дані.

Джерела: Google — довідник API, метод запиту Search Analytics, обмеження використання, отримання всіх даних і посібник з авторизації.