Google Custom Search JSON API дозволяє програмно отримувати результати пошуку Google у форматі JSON через власну пошукову систему Programmable Search Engine. Головне, що варто знати до початку роботи: з 2026 року цей API закритий для нових клієнтів. Існуючим користувачам Google дав час до 1 січня 2027 року на перехід на іншу схему.
Тобто розробник, який раніше не отримував ключ до цього API, зараз не може оформити доступ через звичайну реєстрацію в Google Cloud Console, навіть маючи готовність платити. Це не тимчасове обмеження і не помилка документації, а політика Google, зафіксована на офіційній сторінці продукту. Далі: що саме залишилося доступним, скільки це коштує в гривнях за поточним курсом і чим API відрізняється від трьох сусідніх продуктів з майже однаковою назвою.
Три продукти під однією назвою
Плутанина навколо Custom Search починається з термінології. Більшість матеріалів у видачі цю плутанину не розводять, а посилюють. Programmable Search Engine, тобто безкоштовний вбудований віджет пошуку для власного сайту, працює без API-ключа і без денного ліміту запитів: користувач бачить готову HTML-сторінку. Custom Search JSON API, про який ця стаття, це окремий шар поверх того самого пошукового індексу. Він повертає структуровані дані для власного застосунку, вимагає ключа й ідентифікатора пошукової системи cx та підпорядкований денним квотам.
Третій продукт, Site Restricted JSON API, працював без денного ліміту для пошукових систем, обмежених щонайбільше десятьма сайтами. Google повністю припинив обслуговувати його запити 8 січня 2025 року. Якщо стаття чи форум радить цей варіант як спосіб обійти квоту, порада застаріла щонайменше на рік. Четвертий продукт, Vertex AI Search, це та сама альтернатива, на яку Google офіційно спрямовує колишніх користувачів Custom Search. Це окремий сервіс Google Cloud без безкоштовного рівня, розрахований на пошук по власних масивах даних компанії, а не по відкритому вебу.
Хто ще отримує доступ у 2026 році
Закритий для нових клієнтів означає конкретну технічну річ. Увімкнути Custom Search JSON API можна тільки в тому проєкті Google Cloud, де ключ до нього був отриманий раніше, до закриття реєстрації. Проєкти, створені з нуля зараз, цієї опції в списку API не бачать.
Розбіжність між джерелами тут стосується самого моменту закриття: частина матеріалів називає 2024 рік, частина 2025-й. Пояснення просте. Офіційна сторінка Google фіксує лише поточний стан без дати самої зміни, тоді як сторонні огляди датують подію моментом, коли їхні автори особисто зіткнулися з відмовою в реєстрації. Для практики це означає одне: якщо ключа й ідентифікатора cx ще немає, розраховувати на цей API як на постійне рішення для нового проєкту не варто.
Як отримати ключ і cx, якщо доступ уже є
Для тих, у кого є чинний проєкт з активованим API, послідовність та сама, що й роки тому. Спочатку в панелі керування Programmable Search Engine створюється пошукова система: вказуються сайти для пошуку або вмикається пошук по всьому вебу. Після створення система отримує ідентифікатор cx, який видно в налаштуваннях. Далі в Google Cloud Console для проєкту вмикається сам Custom Search JSON API і генерується ключ доступу.
Останній крок часто пропускають застарілі інструкції: без прив’язаного платіжного акаунта запити обриваються рівно на сотому за добу. Жодних попереджень про наближення до ліміту API не надсилає.
Структура запиту і що повертає відповідь
Запит до API виконується одним HTTP GET на єдину точку входу https://www.googleapis.com/customsearch/v1. Туди передаються три обов’язкові параметри: key для ключа доступу, cx для ідентифікатора пошукової системи і q для самого запиту. Приклад мінімального звернення: https://www.googleapis.com/customsearch/v1?key=ВАШ_КЛЮЧ&cx=ВАШ_CX&q=lectures. Довжина рядка запиту обмежена 2048 символами, що на практиці означає обережність з довгими фільтрами й багатослівними формулюваннями фрази.
Відповідь приходить у форматі JSON з масивом items, де кожен елемент містить заголовок, посилання і фрагмент тексту сторінки. Одне звернення повертає щонайбільше 10 результатів, а параметр start дозволяє гортати сторінки видачі зі значеннями від 1 до 91. Разом це дає жорстку стелю в 100 результатів на один пошуковий запит, навіть якщо реальна видача Google по тій самій фразі набагато довша.
Параметри для мови, країни та зображень
Окрім трьох обов’язкових параметрів, запит приймає ще майже тридцять необов’язкових, і саме вони перетворюють загальний пошук на локалізований. Для української видачі корисні насамперед три: lr=lang_uk обмежує результати документами українською мовою, gl=ua підсилює в ранжуванні сторінки, що походять з України, а cr дозволяє прив’язати пошук до конкретної країни походження документа за допомогою булевих операторів. Жоден з них не є обов’язковим, а без них API просто поверне загальну видачу без прив’язки до ринку.
Параметр num задає кількість результатів в одній відповіді, від 1 до 10, а dateRestrict обмежує видачу за давністю публікації зі значеннями на кшталт d7 для тижня чи m6 для півроку. Для пошуку по зображеннях замість веб-сторінок додається searchType=image, після чого стають доступні додаткові фільтри за розміром, типом і кольором картинки. Параметр siteSearch у парі з siteSearchFilter звужує або, навпаки, виключає результати з конкретного домену в межах уже налаштованої пошукової системи.
Скільки це коштує: розрахунок у гривнях
Безкоштовна квота становить 100 запитів на добу. Понад неї, за умови увімкненого білінгу, кожна тисяча запитів коштує 5 доларів. Денна стеля навіть для платних запитів зафіксована на позначці 10 000 запитів, і підняти її неможливо жодним тарифним планом. Розрахунок для трьох типових навантажень при курсі Нацбанку 44,76 грн за долар станом на 7 серпня 2026 року виглядає так.
| Запитів на добу | Платних запитів на добу | Вартість на місяць, $ | Вартість на місяць, грн |
|---|---|---|---|
| 1 000 | 900 | 135 | 6 043 |
| 5 000 | 4 900 | 735 | 32 899 |
| 10 000 (стеля) | 9 900 | 1 485 | 66 469 |
Стеля в 10 000 платних запитів на добу означає граничний обсяг близько 300 000 запитів на місяць за жодних обставин не більше, скільки б проєкт не платив. Різницю між безкоштовним і максимальним платним рівнем варто тримати в голові поруч із цифрою в 100 безкоштовних запитів: вона стоденна. Це не двадцятикратна чи тридцятикратна різниця, як інтуїтивно здається з формулювання «100 безкоштовних, далі по 5 доларів».
Для чого API не підходить
Стеля у 100 результатів на запит виключає задачі на кшталт повного парсингу видачі по широкій темі чи побудови власного пошукового індексу поверх Google. Конкуренти з невеликими SERP-агрегаторами тут пропонують глибший доступ, хоча й поза офіційною екосистемою Google. Обсяг у кілька тисяч запитів на добу, типовий для інтернет-магазину середнього розміру з внутрішнім пошуком, упирається у платіж, порівнянний з окремим SaaS-сервісом. І головне обмеження лишається організаційним: для нового проєкту без вже виданого ключа шлях до Custom Search JSON API закритий незалежно від готовності платити.
Офіційна позиція Google
Existing Custom Search JSON API customers have until January 1, 2027 to transition…
Google for Developers, сторінка Custom Search JSON API
Ця фраза на офіційній сторінці залишається без зазначеної дати останньої зміни статусу, лише з датою оновлення самої сторінки, 18 лютого 2026 року. Тому будь-яке твердження про точний момент закриття реєстрації, знайдене на сторонньому сайті, варто читати як оцінку автора матеріалу.
Що робити замість реєстрації
Проєктам без наявного ключа Google пропонує Vertex AI Search як офіційну заміну, орієнтовану на пошук по власних масивах документів компанії. Безкоштовного рівня в нього немає, а модель ціноутворення суттєво відрізняється від простої оплати за запит. Для задач, де потрібен саме класичний пошук по відкритих сторінках в обхід відсутньої реєстрації, ринок пропонує сторонні SERP-сервіси. Вони працюють поза інфраструктурою Google і не підпадають під його обмеження на нових клієнтів, зате й не мають статусу продукту Google з усіма наслідками щодо підтримки та стабільності умов.
