Как проверить позицию ключевого слова с помощью Google API (руководство 2026)

Попытка проверить позицию ключевого слова с помощью Google API относится к тем задачам, которые выглядят решённой проблемой, пока вы не попробуете. Метода rankings.get() не существует, а два API Google, к которым люди обращаются первыми, отвечают на немного другой вопрос, чем тот, который задаётся. Правильное место для начала это документация по Search Analytics в Search Console, при условии что вы понимаете, что означает там «позиция».

Есть ли у 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,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-адресов и капчам. Помимо вопроса политики, инженерная реальность неприятна: результаты персонализированы, локализованы и всё чаще формируются с функциями ИИ, поэтому «позиция», полученная парсингом, меняется в зависимости от дата-центра, местоположения и сеанса, даже если на вашем сайте ничего не менялось.

Если вам нужны позиции конкурентов, коммерческий 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 и отслеживает цитирования в ИИ в одном месте.