以網站全部 20 種語言取得 Google、Bing、YouTube、Amazon、樂天市場、Yahoo!、DuckDuckGo、百度、Yandex、Naver、Daum 搜尋建議詞（含展開）的 JSON API。日文以假名（あ–ん）、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 | 樂天市場建議詞 |
yahoo | Yahoo! 搜尋建議詞 |
duckduckgo | DuckDuckGo 建議詞（lang=ja 時回傳日本地區的候選詞） |
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 ※ 依 source 分別計算，已快取的關鍵字不計入 |
超過限制時會回傳 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 | 取得失敗（可於 1 小時後重試） |
| 503 | queue_full | 系統忙碌中（請參閱 Retry-After） |