Команди, які шукають API рейтингу Google, зазвичай хочуть одну конкретну річ: виклик, що повертає, на якій позиції перебуває сторінка за ключовим словом. Google такого не публікує.
Що Google публікує — це набір API, які описують вашу власну ефективність, стан вашого власного індексу та вашу власну ситуацію з обходом. Вони справді корисні, і всі вони безкоштовні. А ще вони структурно не здатні відповісти на питання, з яким більшість людей приходить у цей пошук.
Ми витратили день на вимірювання того, що ці API насправді повертають на живому ресурсі, включно з частинами, які легко прочитати неправильно. Три висновки вирізнилися: дані надходять із запізненням на три дні, число позиції — це середнє, яке не відтворюється проти живого результату, а єдиний API, що звучить найбільше як перевірка позицій, повертає вердикт, який сам собою не говорить нічого корисного.
Що Google насправді публікує
Чотири поверхні плутають з API рейтингу. Ось для чого призначена кожна, за власною документацією Google.
Search Analytics API повертає кліки, покази, CTR і середню позицію для підтвердженого ресурсу. Це найближче до даних про позиції, що пропонує Google, і це джерело кожного числа «середня позиція» в Search Console.
URL Inspection API повертає стан індексації для одного URL: чи знає про нього Google, чи проіндексований він, а якщо ні — чому.
Indexing API звучить так, ніби надсилає сторінки на індексацію. Документація Google обмежує підтримувані типи структурованими даними JobPosting і BroadcastEvent — це вузький сценарій, а не загальне надсилання до індексу.
Custom Search JSON API повертає вебрезультати за запитом. Він шукає в індексі, який налаштовуєте ви, і не повідомляє, на якому місці ваш сайт в основних результатах Google.
Жоден із них не повертає «вашу позицію за цим ключовим словом». Такого завдання в продуктовій лінійці Google немає, і ця відсутність навмисна, а не проґавлена. У Google немає комерційної причини масово роздавати дані про позиції конкурентів.
Що ми виміряли: даним три дні
Ми вивантажили розбивку за днями для власного ресурсу 12 вересня 2026 року. Найсвіжіша дата, за якою були хоч якісь дані, — 9 вересня.
Доступна дата | Повернених рядків |
|---|---|
2026-09-02 | є |
2026-09-03 | є |
2026-09-04 | є |
2026-09-05 | є |
2026-09-06 | є |
2026-09-07 | є |
2026-09-08 | є |
2026-09-09 | є, найсвіжіша |
Відставання в три дні, стабільно. Параметр window рахує назад від найсвіжішої доступної дати, а не від сьогодні, і це невелика пастка: запит на сім днів повертає вісім дат, що закінчуються 9 вересня, а не 12 вересня.
Для місячного звіту це не має значення. Для питання «чи не зламала вчорашня зміна сторінки щось» — це дискваліфікує інструмент. Жодне налаштування цього не виправляє. Затримка на боці Google.
Що ми виміряли: середня позиція — це не місце в рейтингу
Це важливіший висновок, і саме він змушує людей вірити, що API рейтингу в Google існує, просто компанія ухиляється.
Середня позиція — це середнє положення вашого URL за всіма показами періоду, зважене за країнами, пристроями та варіантами запиту. Жива перевірка позицій повертає одне число, з одного місця, на одному пристрої, в один момент. Це два різні вимірювання, які носять одне ім'я.
Ми перевірили розрив на 25 запитах, узятих з наших власних даних Search Console, а потім перевірили ті самі 25 ключових слів проти живої видачі США, англійською, для настільних пристроїв, на глибину 100.
Результат | Кількість |
|---|---|
Запити, придатні в обох наборах | 23 |
З'явилися в живій першій сотні | 14 (61%) |
Мали покази в Search Console, але без відтворюваного живого результату | 9 (39%) |
Медіана абсолютної розбіжності там, де були обидва значення | 7,4 позиції |
Середня абсолютна розбіжність | 8,5 позиції |
Найбільша розбіжність | 36,6 позиції |
У межах 3 позицій одна від одної | 4 з 14 |
Розійшлися більш ніж на 10 позицій | 4 з 14 |
Там, де обидва вимірювання існують, вони розходяться на медіанні 7,4 позиції.
Дві деталі важливіші за середні значення.
По-перше, дев'ять із 23 запитів дали позицію в Search Console, але взагалі не дали живого результату під час перевірки за США, англійською, для настільних пристроїв. Це не помилка. Покази накопичуються з інших країн, іншими мовами, з інших пристроїв і з поверхонь зображень та відео. Одна перевірка з прив'язкою до однієї географії їх не відтворить, і команда, яка поводиться з двома числами як з одним вимірюванням, витратить тиждень на погоню за розбіжністю, яка є артефактом методу.
По-друге, напрямок не сталий. Більшість живих позицій опинилися нижче середнього з Search Console — цього й слід очікувати, коли середнє включає поверхні з кращою ефективністю. Але один запит зсунувся на 36,6 позиції в інший бік, із 73,6 на 37. Застосовувати тут нічого — жодного коефіцієнта корекції не існує.
Розбіжність іде в обидва боки, тому коефіцієнта корекції немає.
Практичний висновок для того, хто обирає API рейтингу Google: безкоштовні дані не назвуть вам позицію, а платні з ними не погодяться. Обидві сторони коректно вимірюють різні речі. Саме на спробі підмінити одну одною звітність і ламається.
А от де перша сторона справді незамінна — це покриття, і ми виміряли його окремо в порівнянні альтернатив SERP API.
Що натомість повертає URL Inspection API
URL Inspection API — єдина поверхня Google, яка відчувається як перевірка позицій, бо ви віддаєте їй URL без ключового слова й отримуєте статус. Ми перевірили два URL.
Стан URL | Вердикт | Стан покриття | Час останнього обходу |
|---|---|---|---|
Опубліковано приблизно годину тому | NEUTRAL | URL невідомий Google | Невідомо |
Опубліковано приблизно дев'ять годин тому | NEUTRAL | Виявлено, наразі не проіндексовано | Невідомо |
Обидва повернули той самий вердикт. Поле, яке справді розрізняє ці два випадки, — це рядок стану покриття, а це речення, а не перелік. Поле вердикту повертає NEUTRAL і для URL, якого Google ніколи не бачив, і для URL, який вона виявила, але не проіндексувала.
Це робочий API і слабкий сигнал моніторингу сам собою. Якщо ви хочете отримувати сповіщення, коли сторінка не проіндексована, розбирайте стан покриття, а не вердикт, і будьте готові до того, що час останнього обходу буде відсутній саме в тих URL, які для вас найважливіші.
Чотири поверхні та завдання, якого не виконує жодна з них
Питання | Поверхня Google | Відповідь |
|---|---|---|
Як я виступив за цим запитом минулого тижня | Search Analytics API | Так, із запізненням на три дні, усереднено |
Чи проіндексовано цей URL | URL Inspection API | Так, за URL, на запит |
На якому місці я зараз за будь-яким ключовим словом | немає | Ні |
На якому місці мої конкуренти | немає | Ні |
Як виглядає видача за словом, за яким я не ранжуюся | немає | Ні |
Закономірність послідовна. API Google описують ваш ресурс зсередини. Питання про позицію ставиться ззовні, про сторінку результатів, і Google цього не надає.
Як закрити розрив, не переплачуючи
Практична схема — два джерела з різними завданнями, а не одне джерело, у якого просять і те, і те.
Використовуйте API Google як основну істину про власний ресурс. Кліки, покази та стан індексації — це дані першої сторони, яких більше ніде не отримати, і вони безкоштовні. Вивантажуйте їх за розкладом і ставтеся до триденної затримки як до властивості самого вимірювального приладу.
Використовуйте джерело SERP для погляду ззовні. Живі позиції, позиції конкурентів і ключові слова, за якими ви ще не ранжуєтеся. Це платна частина, і вона дешевша, ніж припускає більшість команд: у нашій перевірці перевірка 23 ключових слів на глибину 100 коштувала $0,2975, тобто $0,0129 за перевірку.
Не намагайтеся узгодити ці два числа. Вони вимірюють різні речі. Корисний хід — читати їх разом: Search Console каже, що сталося, а жива перевірка каже, що відбувається. Коли вони розходяться, подивіться на склад країн і пристроїв для цього запиту, перш ніж робити висновки.
Механіку запуску обох з одного скрипта описано в нашій збірці трекера з двома джерелами, а вартість живої половини пораховано в тесті масової перевірки.
Часті запитання
Чи має Google офіційний API рейтингу? Ні. Google публікує API для вашої власної пошукової ефективності (Search Analytics), стану індексації (URL Inspection) і двох вузьких типів надсилання (Indexing). Жоден із них не повертає позицію за ключовим словом.
Чому Search Console показує позицію, якщо API рейтингу немає? Бо середня позиція — це метрика ефективності, обчислювана з ваших показів, а не запит позиції. Це середнє положення за всіма показами періоду, усереднене за країнами, пристроями та поверхнями.
Наскільки відстають дані Search Console? На три дні в нашому вимірюванні 12 вересня 2026 року, причому найсвіжіша доступна дата — 9 вересня. Параметр window рахує назад від цієї дати, тож запит на сім днів повертає вісім дат, що закінчуються на найсвіжішій доступній.
Чи може URL Inspection API сказати, чи проіндексовано сторінку? Так, і це слушний інструмент для такого завдання. Читайте рядок стану покриття, а не поле вердикту, бо вердикт повертає NEUTRAL і для невідомого URL, і для виявленого, але не проіндексованого.
Чи є Custom Search JSON API API рейтингу? Ні. Він повертає результати з пошукової системи, яку налаштовуєте ви, а не вашу позицію в основних результатах Google.
Який найдешевший спосіб отримати справжні дані про позиції? Перевіряйте найменший набір ключових слів, за якими ви справді щось робите, на глибині, що відповідає вашим позиціям. Перевірка на глибину 10 коштувала в нашому тесті $0,002 за ключове слово, а на глибину 100 — $0,014, тобто налаштування глибини рухає рахунок у сім разів сильніше, ніж кількість ключових слів.
Погляд Auspia: чесна відповідь на питання «чи є в Google API рейтингу» — ні, і корисне продовження — перестати його шукати. API Google добре відповідають на питання першої сторони й зовсім не можуть відповісти на питання про позиції. Закладіть невелику суму на погляд ззовні, а решту зусиль витратьте на те, чого Google за вас не зробить: на рішення, що змінити, коли два числа розходяться.
Автор: Габріель Фінч, дослідник пошукового вилучення, перевірка понад 1 200 відповідей ШІ в Auspia. Матеріали про пошукову інфраструктуру, системи вилучення та про те, що насправді бачить кожне джерело даних.
