Eine JSON-API, die die Suchvorschläge von Google, Bing, YouTube, Amazon, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver und Daum samt Erweiterungen in allen 20 Sprachen der Website liefert. Japanisch wird mit den Silben der Kana-Schrift (あ–ん), A–Z und 0–9 erweitert, andere Sprachen mit einem Leerzeichen plus den eigenen Buchstaben der Sprache, A–Z und 0–9. Der Einstieg ist mit dem kostenlosen Tarif möglich (Preise).
Ein API-Schlüssel ist erforderlich. Melden Sie sich an und erstellen Sie im Benutzermenü unter „API“ einen Schlüssel. Senden Sie ihn bei jeder Anfrage mit.
Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Verwenden Sie den Schlüssel nur serverseitig. Wenn Sie ihn in Browser-JavaScript einbetten, können Dritte ihn verwenden.
Setzen Sie {source} auf einen der folgenden Werte.
| source | Liefert |
|---|---|
google | Google-Suchvorschläge |
bing | Bing-Suchvorschläge |
youtube | YouTube-Suchvorschläge |
amazon | Amazon-Suchvorschläge (ja: Amazon.co.jp; andere Sprachen: der Hauptmarktplatz der jeweiligen Sprache) |
rakuten | Suchvorschläge von Rakuten Ichiba (Japan) |
yahoo | Vorschläge der Yahoo!-Suche |
duckduckgo | DuckDuckGo-Suchvorschläge (lang=ja liefert Vorschläge für Japan) |
baidu | Baidu-Suchvorschläge (zh, zh-tw, ja, en) |
yandex | Yandex-Suchvorschläge (ru, uk, tr) |
naver | Naver-Suchvorschläge (ko) |
daum | Daum-Suchvorschläge (ko) |
| Parameter | Beschreibung |
|---|---|
q (erforderlich) | Suchbegriff (1–60 Zeichen). Voll- und Halbbreitenzeichen, Groß-/Kleinschreibung und Leerzeichen werden normalisiert. |
lang | ja (Standard), en, ru, ko, zh und die übrigen Sprachcodes der Website (insgesamt 20). ja ergänzt die Kana-Erweiterung (nihongo), andere Sprachen ein Leerzeichen plus ihre eigenen Buchstaben (native). en hat keine von beiden. |
group | all (Standard) oder eine kommagetrennte Liste aus itself,nihongo,native,alphabet,number. |
flat | Mit 1 wird ein einzelnes Array suggestions ohne Duplikate zurückgegeben. |
Das Abrufen eines noch nicht zwischengespeicherten Suchbegriffs dauert einige Dutzend Sekunden. Die API antwortet daher zunächst mit 202 und stellt ihn in die Warteschlange. Senden Sie nach retry_after_seconds dieselbe Anfrage erneut; sobald die Daten vorliegen, erhalten Sie 200 mit den Ergebnissen. Ergebnisse werden 7 Tage lang zwischengespeichert. Nach Ablauf werden die alten Daten mit "stale": true zurückgegeben, während sie aktualisiert werden. Der Cache ist für jede Kombination aus source, q und lang getrennt.
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 (in Warteschlange)
{ "ok": true, "status": "queued", "source": "google", "queue_position": 3, "retry_after_seconds": 24, ... }
// 200 (bereit)
{ "ok": true, "status": "ready", "query": "ランニング", "source": "google", "fetched_at": "2026-09-19T01:02:03Z",
"stale": false, "count": 412, "suggestions": ["ランニング シューズ", "..."] }
GET /api/v1/usage — Nutzung Ihres Schlüssels in den letzten 30 Tagen und Limits Ihres Tarifs (Authentifizierung erforderlich)GET /api/v1/status — Länge der Warteschlange und Status der Worker (ohne Authentifizierung)| Begrenzung | Höchstwert |
|---|---|
| Anfragen pro Minute | 30 |
| Anfragen pro Tag (UTC) | 1,000 |
| Neue (nicht zwischengespeicherte) Suchbegriffe pro Tag | 20 Wird pro Quelle gezählt. Bereits zwischengespeicherte Suchbegriffe werden nicht angerechnet. |
Bei Überschreitung eines Limits antwortet die API mit 429 und Retry-After. Jede Antwort enthält X-RateLimit-Limit / Remaining / Reset und X-Daily-Limit / X-Daily-Remaining.
| HTTP | code | Bedeutung |
|---|---|---|
| 400 | invalid_query / invalid_lang / invalid_group | Ungültiger Parameter (auch ein für diese Sprache nicht angebotenes source) |
| 401 | invalid_api_key | Schlüssel fehlt oder ist ungültig |
| 404 | not_found | Ungültige source oder ungültiger Pfad |
| 429 | rate_limited / daily_quota_exceeded / new_keyword_quota_exceeded | Limit überschritten (siehe Retry-After) |
| 502 | upstream_failed | Abruf fehlgeschlagen (erneuter Versuch nach einer Stunde möglich) |
| 503 | queue_full | Überlastet (siehe Retry-After) |
Nutzungsbedingungen (English) · Datenschutzerklärung (English)