JSON API, що повертає пошукові підказки (автодоповнення) Google, Bing, YouTube, Amazon, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver і Daum із розширеннями всіма 20 мовами сайту. Для японської запит розширюється складами абетки кана (あ–ん), A–Z і 0–9, для інших мов — пробілом і літерами самої мови, A–Z і 0–9. Почати можна з безкоштовного тарифу (ціни).
Потрібен ключ API. Увійдіть і створіть ключ у меню користувача, у розділі «API». Передавайте його в кожному запиті.
Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Використовуйте ключ лише на боці сервера. Якщо вбудувати його в JavaScript у браузері, ним зможуть скористатися сторонні особи.
Замість {source} вкажіть одне з таких значень.
| source | Що повертає |
|---|---|
google | Підказки Google |
bing | Підказки Bing |
youtube | Підказки YouTube |
amazon | Підказки Amazon (ja: Amazon.co.jp; інші мови: основний маркетплейс цієї мови) |
rakuten | Підказки Rakuten Ichiba (Японія) |
yahoo | Підказки пошуку Yahoo! |
duckduckgo | Підказки DuckDuckGo (lang=ja — підказки для Японії) |
baidu | Підказки Baidu (zh, zh-tw, ja, en) |
yandex | Підказки Yandex (ru, uk, tr) |
naver | Підказки Naver (ko) |
daum | Підказки Daum (ko) |
| Параметр | Опис |
|---|---|
q (обов’язковий) | Ключове слово (1–60 символів). Повноширинні й напівширинні символи, регістр і пробіли нормалізуються. |
lang | ja (за замовчуванням), en, ru, ko, zh та інші коди мов сайту (усього 20). ja додає розширення за каною (nihongo), інші мови — пробіл і власні літери (native). У en немає ні того, ні іншого. |
group | all (за замовчуванням) або список через кому з itself,nihongo,native,alphabet,number. |
flat | З 1 повертається один масив suggestions без дублікатів. |
Отримання ключового слова, якого ще немає в кеші, триває десятки секунд, тому API спершу повертає 202 і ставить запит у чергу. Через retry_after_seconds надішліть той самий запит повторно: коли дані будуть готові, ви отримаєте 200 з результатами. Результати кешуються на 7 днів. Після закінчення терміну, поки дані оновлюються, повертаються старі дані з "stale": true. Кеш ведеться окремо для кожного поєднання source, q і lang.
curl -H "Authorization: Bearer $KEY" \ "https://gstudio1.com/api/v1/google/suggest?q=%E3%83%A9%E3%83%B3%E3%83%8B%E3%83%B3%E3%82%B0&flat=1" curl -H "Authorization: Bearer $KEY" \ "https://gstudio1.com/api/v1/rakuten/suggest?q=%E3%83%A9%E3%83%B3%E3%83%8B%E3%83%B3%E3%82%B0&flat=1"
// 202 (у черзі)
{ "ok": true, "status": "queued", "source": "google", "queue_position": 3, "retry_after_seconds": 24, ... }
// 200 (готово)
{ "ok": true, "status": "ready", "query": "ランニング", "source": "google", "fetched_at": "2026-09-19T01:02:03Z",
"stale": false, "count": 412, "suggestions": ["ランニング シューズ", "..."] }
GET /api/v1/usage — Використання вашого ключа за останні 30 днів і ліміти тарифу (потрібна автентифікація)GET /api/v1/status — Довжина черги та стан воркерів (без автентифікації)| Показник | Ліміт |
|---|---|
| Запитів за хвилину | 30 |
| Запитів за добу (UTC) | 1,000 |
| Нових (некешованих) ключових слів за добу | 20 Рахується окремо для кожного джерела. Ключові слова, що вже є в кеші, не враховуються. |
У разі перевищення ліміту API повертає 429 і Retry-After. Кожна відповідь містить X-RateLimit-Limit / Remaining / Reset і X-Daily-Limit / X-Daily-Remaining.
| HTTP | code | Значення |
|---|---|---|
| 400 | invalid_query / invalid_lang / invalid_group | Некоректний параметр (зокрема source, недоступний для цієї мови) |
| 401 | invalid_api_key | Ключ відсутній або недійсний |
| 404 | not_found | Некоректний source або шлях |
| 429 | rate_limited / daily_quota_exceeded / new_keyword_quota_exceeded | Ліміт перевищено (див. Retry-After) |
| 502 | upstream_failed | Не вдалося отримати дані (повторити можна через годину) |
| 503 | queue_full | Сервіс перевантажено (див. Retry-After) |
Умови використання (English) · Політика конфіденційності (English)