一个以网站全部 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） |