Як перевірити позицію ключового слова за допомогою Google API (посібник 2026)

Спроба перевірити позицію ключового слова за допомогою Google API належить до тих завдань, які здаються вирішеними, доки ви справді не спробуєте. Немає кінцевої точки rankings.get(), а два API Google, до яких люди звертаються першими, відповідають на трохи інше питання, ніж те, яке ставиться. Документація Search Console Search Analytics це правильне місце для початку, за умови, що ви розумієте, що там означає «позиція».

Чи є в Google офіційний API позицій ключових слів?

Ні. Google ніколи не випускав API, який приймає ключове слово й повертає вашу живу позицію на google.com. Це зроблено навмисно: автоматизоване опитування сторінки результатів пошуку заборонене умовами Google, а в компанії немає комерційного інтересу постачати інфраструктуру відстеження позицій.

Натомість існують три часткові шляхи, кожен зі своєю жорсткою межею:

Як отримати позиції ключових слів з API Search Console?

Надішліть запит до кінцевої точки searchAnalytics із виміром query і прочитайте поле position. Це дані з перших рук безпосередньо від Google, вони безкоштовні й без ліміту ключових слів: ви отримуєте кожен запит, за яким ваш сайт мав покази.

Робочий запит на Python:

from google.oauth2 import service_account
from googleapiclient.discovery import build

creds = service_account.Credentials.from_service_account_file(
    "service-account.json",
    scopes=["https://www.googleapis.com/auth/webmasters.readonly"],
)
service = build("searchconsole", "v1", credentials=creds)

response = service.searchanalytics().query(
    siteUrl="https://example.com/",
    body={
        "startDate": "2026-07-01",
        "endDate": "2026-07-31",
        "dimensions": ["query", "page"],
        "rowLimit": 25000,
    },
).execute()

for row in response.get("rows", []):
    query, page = row["keys"]
    print(f"{row['position']:.1f}  {query}  ->  {page}")

Три обмеження, на яких спотикаються

• Позиція це середнє значення, а не місце. Значення 7,4 не означає, що ви стоїте на позиції 7; воно означає, що покази були розподілені між позиціями із середнім 7,4, можливо, від 3 до 15 залежно від пристроїв і місць.
• Лише ваш сайт. Побачити позицію конкурента неможливо. Search Console за задумом є API, прив'язаним до ресурсу.
• Ключові слова без показів невидимі. Якщо ви на позиції 60 і ніхто не прокрутив так далеко, запит взагалі не з'явиться в даних.

Третій пункт непомітно псує звітність. Ключового слова, з яким ви ще не пробилися на перші сторінки, у Search Console просто не існує, тож виміряти прогрес із позиції 60 до позиції 20 лише за допомогою цього API неможливо.

Чи можна використати API Custom Search JSON для перевірки позицій?

Технічно так, змістовно ні. API Custom Search JSON вимагає спершу створити Programmable Search Engine. Навіть налаштований на пошук по всьому вебу, він застосовує власне ранжування й власні обмеження, тож порядок, який він повертає, не збігається з порядком google.com.

Він також обмежений 100 запитами на день у безкоштовному тарифі, а платне використання тарифікується за тисячу запитів із денною стелею. Для кількох ключових слів, що перевіряються зрідка, це придатно. Як трекер позицій він видає числа, які виглядають авторитетно й непомітно хибні, а це гірше, ніж відсутність даних.

А що з прямим скрейпінгом Google?

Не робіть цього. Автоматизоване опитування пошуку Google без дозволу суперечить Умовам надання послуг Google, а за будь-якого обсягу призводить до блокування IP-адрес і сторін із CAPTCHA. Окрім питання політик, інженерна реальність неприємна: результати персоналізовані, локалізовані й дедалі частіше формуються з використанням функцій ШІ, тож «позиція», отримана скрейпінгом, змінюється залежно від дата-центру, місця та сесії, навіть коли нічого не змінилося на вашому сайті.

Якщо вам потрібні позиції конкурентів, комерційний SERP API це шлях, що є і законним за власними угодами постачальника, і операційно стабільним. Це платна стаття витрат, і ця вартість є чесною ціною даних, які Google не роздає. Компанії, яким потрібно побудувати й підтримувати цей конвеєр без найму власних фахівців, зазвичай залучають спеціаліста; наше порівняння 10 найкращих агентств із аналітики даних у Франції перелічує виконавців, які налаштовують таку звітність.

Що насправді варто будувати?

Для більшості команд прагматична архітектура гібридна, і виглядає вона так:

• API Search Console як основа. Безкоштовний, без ліміту ключових слів, з перших рук і єдине джерело, яке показує, за чим ви справді отримуєте покази.
• SERP API для невеликого добірного набору ключових слів. Ваші двадцять чи тридцять комерційно критичних запитів, які перевіряються щодня, разом із позиціями конкурентів.
• Шар видимості в ШІ. Дедалі частіше питання не лише «яка в мене позиція», а й «чи цитують мене, коли хтось питає асистента». Класичні API позицій на це не відповідають.

Команди, які не хотіли б самостійно проєктувати це, зазвичай передають задачу спеціалісту; наше порівняння 10 найкращих SEO-агентств у Франції описує виконавців, які ведуть цей стек звітності для клієнтів.

Цей останній пункт не є турботою на майбутнє. Коли відповідь ШІ розв'язує запит в інтерфейсі, десята й третя позиції зводяться до того самого результату: немає кліку. Відстеження цитувань поряд з позиціями це те, для чого створено наш сервер Search Console MCP і платформу видимості в ШІ, а документація охоплює налаштування від початку до кінця.

Висновок

Офіційного API Google для живих позицій ключових слів немає: використовуйте API Search Console для власних усереднених даних, сторонній SERP API для точних і конкурентних позицій, а API Custom Search JSON для роботи з позиціями пропустіть повністю. Будувати на хибному API це найпоширеніша помилка тут, яка дає дашборд, що впевнено показує неточні дані.

Якщо ви не хочете самостійно будувати й підтримувати цей конвеєр, Sorank підключає вашу Search Console і відстежує цитування в ШІ в одному місці.