API JSON yang mengembalikan saran pencarian Google, Bing, YouTube, Amazon, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver, dan Daum beserta perluasannya dalam ke-20 bahasa situs. Bahasa Jepang diperluas dengan aksara kana (あ–ん), A–Z, dan 0–9; bahasa lain dengan spasi ditambah huruf khas bahasa tersebut, A–Z, dan 0–9. Anda bisa mulai dengan paket gratis (harga).
Kunci API wajib digunakan. Masuk, lalu buat kunci dari "API" di menu pengguna. Sertakan kunci di setiap permintaan.
Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Gunakan kunci hanya dari server Anda. Jika disematkan di JavaScript browser, kunci bisa dipakai orang lain.
Ganti {source} dengan salah satu nilai berikut.
| source | Hasil |
|---|---|
google | Saran Google |
bing | Saran Bing |
youtube | Saran YouTube |
amazon | Saran Amazon (ja: Amazon.co.jp; bahasa lain: marketplace utama bahasa tersebut) |
rakuten | Saran Rakuten Ichiba (Jepang) |
yahoo | Saran pencarian Yahoo! |
duckduckgo | Saran DuckDuckGo (lang=ja mengembalikan saran untuk Jepang) |
baidu | Saran Baidu (zh, zh-tw, ja, en) |
yandex | Saran Yandex (ru, uk, tr) |
naver | Saran Naver (ko) |
daum | Saran Daum (ko) |
| Parameter | Keterangan |
|---|---|
q (wajib) | Kata kunci (1–60 karakter). Karakter lebar penuh/setengah lebar, huruf besar/kecil, dan spasi dinormalisasi. |
lang | ja (default), en, ru, ko, zh, dan kode bahasa situs lainnya (total 20). ja menambahkan perluasan kana (nihongo); bahasa lain menambahkan spasi dan huruf khasnya (native). en tidak memiliki keduanya. |
group | all (default) atau daftar yang dipisahkan koma dari itself,nihongo,native,alphabet,number. |
flat | 1 mengembalikan satu array suggestions tanpa duplikat. |
Mengambil kata kunci yang belum ada di cache memerlukan puluhan detik, jadi API terlebih dahulu mengembalikan 202 dan memasukkannya ke antrean. Kirim permintaan yang sama lagi setelah retry_after_seconds; jika data sudah siap, Anda akan menerima 200 beserta hasilnya. Hasil disimpan di cache selama 7 hari. Setelah kedaluwarsa, data lama tetap dikembalikan dengan "stale": true selama data diperbarui. Cache terpisah untuk setiap kombinasi source, q, dan 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 (dalam antrean)
{ "ok": true, "status": "queued", "source": "google", "queue_position": 3, "retry_after_seconds": 24, ... }
// 200 (siap)
{ "ok": true, "status": "ready", "query": "ランニング", "source": "google", "fetched_at": "2026-09-19T01:02:03Z",
"stale": false, "count": 412, "suggestions": ["ランニング シューズ", "..."] }
GET /api/v1/usage — Penggunaan kunci Anda selama 30 hari terakhir dan batas paket (perlu autentikasi)GET /api/v1/status — Panjang antrean dan status worker (tanpa autentikasi)| Item | Batas |
|---|---|
| Permintaan per menit | 30 |
| Permintaan per hari (UTC) | 1,000 |
| Kata kunci baru (belum di-cache) per hari | 20 Dihitung terpisah untuk setiap source. Kata kunci yang sudah ada di cache tidak dihitung. |
Jika batas terlampaui, API mengembalikan 429 dengan Retry-After. Setiap respons menyertakan X-RateLimit-Limit / Remaining / Reset dan X-Daily-Limit / X-Daily-Remaining.
| HTTP | code | Arti |
|---|---|---|
| 400 | invalid_query / invalid_lang / invalid_group | Parameter tidak valid (termasuk source yang tidak tersedia untuk bahasa tersebut) |
| 401 | invalid_api_key | Kunci tidak ada atau tidak valid |
| 404 | not_found | source atau path tidak valid |
| 429 | rate_limited / daily_quota_exceeded / new_keyword_quota_exceeded | Batas terlampaui (lihat Retry-After) |
| 502 | upstream_failed | Gagal mengambil data (bisa dicoba lagi setelah satu jam) |
| 503 | queue_full | Sedang sibuk (lihat Retry-After) |
Ketentuan Layanan (English) · Kebijakan Privasi (English)