Suggest API v1

Google・Bing・YouTube・Amazon・楽天市場・Yahoo!のサジェストワード(あ〜ん・A〜Z・0〜9の展開込み)を取得するJSON APIです。現在は無料で提供しています。

認証

APIキーが必須です。キーは ログイン 後、ユーザーメニューの「API」から発行できます。全リクエストに付与してください。

Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

キーはサーバー側から利用してください(ブラウザのJavaScriptに埋め込むと第三者に使われます)。

GET /api/v1/{source}/suggest

{source} には以下のいずれかを指定します。

source対象
googleGoogleサジェスト
bingBingサジェスト
youtubeYouTubeサジェスト
amazonAmazon.co.jpサジェスト
rakuten楽天市場サジェスト
yahooYahoo!検索サジェスト
パラメータ説明
q (必須)キーワード(1〜60文字)。全角/半角・大文字小文字・空白は正規化されます。
langja(既定) / en。enでは日本語の五十音展開を行いません。
groupall(既定) または itself,nihongo,alphabet,number のカンマ区切り。
flat1 で重複を除いた suggestions 配列として返します。

非同期の仕組み

未取得のキーワードは取得に数十秒かかるため、まず 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": ["ランニング シューズ", "..."] }

その他のエンドポイント

制限(無料プラン)

項目上限
リクエスト/分30
リクエスト/日 (UTC)1,000
新規(未キャッシュ)キーワード/日20 ※source別にカウントされ、取得済みキーワードは消費しません

超過時は 429 と Retry-After を返します。全レスポンスに X-RateLimit-Limit / Remaining / Reset と X-Daily-Limit / X-Daily-Remaining が付きます。

エラー

HTTPcode意味
400invalid_query / invalid_lang / invalid_groupパラメータ不正
401invalid_api_keyキーが無い/無効
404not_foundsourceやパスが不正
429rate_limited / daily_quota_exceeded / new_keyword_quota_exceeded制限超過(Retry-After参照)
502upstream_failed取得に失敗(1時間後に再試行可)
503queue_full混雑中(Retry-After参照)

ご利用にあたって