API JSON, które zwraca sugestie wyszukiwania (autouzupełnianie) z Google, Bing, YouTube, Amazon, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver i Daum wraz z rozszerzeniami we wszystkich 20 językach serwisu. Japoński jest rozszerzany o sylaby pisma kana (あ–ん), A–Z i 0–9, pozostałe języki o spację z literami danego języka, A–Z i 0–9. Możesz zacząć od planu darmowego (cennik).
Wymagany jest klucz API. Zaloguj się i wygeneruj klucz w menu użytkownika, w pozycji „API”. Dołączaj go do każdego żądania.
Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Używaj klucza wyłącznie po stronie serwera. Jeśli osadzisz go w JavaScripcie w przeglądarce, inni będą mogli z niego korzystać.
Jako {source} podaj jedną z poniższych wartości.
| source | Zwraca |
|---|---|
google | Sugestie Google |
bing | Sugestie Bing |
youtube | Sugestie YouTube |
amazon | Sugestie Amazon (ja: Amazon.co.jp; inne języki: główny sklep danego języka) |
rakuten | Sugestie Rakuten Ichiba (Japonia) |
yahoo | Sugestie wyszukiwarki Yahoo! |
duckduckgo | Sugestie DuckDuckGo (lang=ja zwraca sugestie dla Japonii) |
baidu | Sugestie Baidu (zh, zh-tw, ja, en) |
yandex | Sugestie Yandex (ru, uk, tr) |
naver | Sugestie Naver (ko) |
daum | Sugestie Daum (ko) |
| Parametr | Opis |
|---|---|
q (wymagany) | Słowo kluczowe (1–60 znaków). Znaki pełnej i połówkowej szerokości, wielkość liter oraz spacje są normalizowane. |
lang | ja (domyślnie), en, ru, ko, zh i pozostałe kody języków serwisu (łącznie 20). ja dodaje rozszerzenie o kana (nihongo), pozostałe języki spację z własnymi literami (native). en nie ma żadnego z nich. |
group | all (domyślnie) lub lista rozdzielona przecinkami z itself,nihongo,native,alphabet,number. |
flat | 1 zwraca jedną tablicę suggestions bez duplikatów. |
Pobranie słowa kluczowego, którego nie ma jeszcze w pamięci podręcznej, trwa kilkadziesiąt sekund, dlatego API najpierw zwraca 202 i dodaje je do kolejki. Po retry_after_seconds wyślij to samo żądanie ponownie; gdy dane będą gotowe, otrzymasz 200 z wynikami. Wyniki są przechowywane w pamięci podręcznej przez 7 dni. Po ich wygaśnięciu, na czas odświeżania, zwracane są stare dane z "stale": true. Pamięć podręczna jest oddzielna dla każdej kombinacji source, q i 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 (w kolejce)
{ "ok": true, "status": "queued", "source": "google", "queue_position": 3, "retry_after_seconds": 24, ... }
// 200 (gotowe)
{ "ok": true, "status": "ready", "query": "ランニング", "source": "google", "fetched_at": "2026-09-19T01:02:03Z",
"stale": false, "count": 412, "suggestions": ["ランニング シューズ", "..."] }
GET /api/v1/usage — Wykorzystanie Twojego klucza w ostatnich 30 dniach i limity planu (wymaga uwierzytelnienia)GET /api/v1/status — Długość kolejki i stan workerów (bez uwierzytelniania)| Pozycja | Limit |
|---|---|
| Żądania na minutę | 30 |
| Żądania na dzień (UTC) | 1,000 |
| Nowe słowa kluczowe (spoza pamięci podręcznej) na dzień | 20 Liczone osobno dla każdego źródła. Słowa kluczowe już zapisane w pamięci podręcznej nie są wliczane. |
Po przekroczeniu limitu API zwraca 429 z nagłówkiem Retry-After. Każda odpowiedź zawiera X-RateLimit-Limit / Remaining / Reset oraz X-Daily-Limit / X-Daily-Remaining.
| HTTP | code | Znaczenie |
|---|---|---|
| 400 | invalid_query / invalid_lang / invalid_group | Nieprawidłowy parametr (w tym source niedostępny dla danego języka) |
| 401 | invalid_api_key | Brak klucza lub klucz nieprawidłowy |
| 404 | not_found | Nieprawidłowe source lub ścieżka |
| 429 | rate_limited / daily_quota_exceeded / new_keyword_quota_exceeded | Przekroczono limit (zob. Retry-After) |
| 502 | upstream_failed | Pobieranie nie powiodło się (ponowna próba możliwa po godzinie) |
| 503 | queue_full | Przeciążenie (zob. Retry-After) |
Warunki korzystania (English) · Polityka prywatności (English)