Een JSON-API die de zoeksuggesties (autocomplete) van Google, Bing, YouTube, Amazon, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver en Daum inclusief uitbreidingen teruggeeft in alle 20 talen van de site. Japans wordt uitgebreid met de lettergrepen van het kana-schrift (あ–ん), A–Z en 0–9; andere talen met een spatie plus de eigen letters van de taal, A–Z en 0–9. Je kunt beginnen met het gratis abonnement (prijzen).
Een API-sleutel is verplicht. Log in en maak een sleutel aan via "API" in het gebruikersmenu. Stuur de sleutel mee met elke aanvraag.
Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Gebruik de sleutel alleen vanaf je server. Als je hem in JavaScript in de browser opneemt, kunnen anderen hem gebruiken.
Vul voor {source} een van de volgende waarden in.
| source | Levert |
|---|---|
google | Google-suggesties |
bing | Bing-suggesties |
youtube | YouTube-suggesties |
amazon | Amazon-suggesties (ja: Amazon.co.jp; andere talen: de belangrijkste marktplaats van die taal) |
rakuten | Suggesties van Rakuten Ichiba (Japan) |
yahoo | Suggesties van Yahoo! Search |
duckduckgo | DuckDuckGo-suggesties (lang=ja geeft suggesties voor Japan) |
baidu | Baidu-suggesties (zh, zh-tw, ja, en) |
yandex | Yandex-suggesties (ru, uk, tr) |
naver | Naver-suggesties (ko) |
daum | Daum-suggesties (ko) |
| Parameter | Beschrijving |
|---|---|
q (verplicht) | Zoekwoord (1–60 tekens). Tekens van volle en halve breedte, hoofd- en kleine letters en spaties worden genormaliseerd. |
lang | ja (standaard), en, ru, ko, zh en de andere taalcodes van de site (20 in totaal). ja voegt de kana-uitbreiding toe (nihongo); andere talen een spatie plus hun eigen letters (native). en heeft geen van beide. |
group | all (standaard) of een kommagescheiden lijst van itself,nihongo,native,alphabet,number. |
flat | Met 1 krijg je één ontdubbelde array suggestions terug. |
Het ophalen van een zoekwoord dat nog niet in de cache staat, duurt tientallen seconden. Daarom geeft de API eerst 202 terug en zet het zoekwoord in de wachtrij. Stuur na retry_after_seconds dezelfde aanvraag opnieuw; zodra de gegevens klaar zijn, krijg je 200 met de resultaten. Resultaten worden 7 dagen gecachet. Daarna worden de oude gegevens met "stale": true teruggegeven terwijl ze worden vernieuwd. De cache staat los per combinatie van source, q en 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 (in wachtrij)
{ "ok": true, "status": "queued", "source": "google", "queue_position": 3, "retry_after_seconds": 24, ... }
// 200 (klaar)
{ "ok": true, "status": "ready", "query": "ランニング", "source": "google", "fetched_at": "2026-09-19T01:02:03Z",
"stale": false, "count": 412, "suggestions": ["ランニング シューズ", "..."] }
GET /api/v1/usage — Gebruik van je sleutel in de afgelopen 30 dagen en de limieten van je abonnement (authenticatie vereist)GET /api/v1/status — Wachtrijlengte en status van de workers (geen authenticatie nodig)| Onderdeel | Limiet |
|---|---|
| Aanvragen per minuut | 30 |
| Aanvragen per dag (UTC) | 1,000 |
| Nieuwe (niet-gecachete) zoekwoorden per dag | 20 Wordt per source geteld. Zoekwoorden die al in de cache staan, tellen niet mee. |
Bij overschrijding geeft de API 429 terug met Retry-After. Elke response bevat X-RateLimit-Limit / Remaining / Reset en X-Daily-Limit / X-Daily-Remaining.
| HTTP | code | Betekenis |
|---|---|---|
| 400 | invalid_query / invalid_lang / invalid_group | Ongeldige parameter (ook een source die voor die taal niet wordt aangeboden) |
| 401 | invalid_api_key | Sleutel ontbreekt of is ongeldig |
| 404 | not_found | Ongeldige source of ongeldig pad |
| 429 | rate_limited / daily_quota_exceeded / new_keyword_quota_exceeded | Limiet overschreden (zie Retry-After) |
| 502 | upstream_failed | Ophalen mislukt (na een uur opnieuw te proberen) |
| 503 | queue_full | Overbelast (zie Retry-After) |
Servicevoorwaarden (English) · Privacybeleid (English)