Suggest API v1

Et JSON-API som leverer søkeforslag (inkludert utvidelser) fra Google, Bing, YouTube, Amazon, eBay, Shopee, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver og Daum på nettstedets 50 språk. Japansk utvides med kana (あ–ん), A–Z og 0–9, de andre språkene med mellomrom pluss språkets egne bokstaver (for eksempel æ ø å på norsk), A–Z og 0–9. Du kan starte med gratisplanen (priser).

Autentisering

Du trenger en API-nøkkel. Logg inn, og opprett en nøkkel under «API» i brukermenyen. Send den med i alle forespørsler.

Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Bruk nøkkelen bare fra serveren din. Hvis du legger den inn i JavaScript i nettleseren, kan andre bruke den.

GET /api/v1/{source}/suggest

Sett {source} til en av følgende verdier.

source	Leverer
`google`	Google-søkeforslag
`bing`	Bing-søkeforslag
`youtube`	YouTube-søkeforslag
`amazon`	Amazon-søkeforslag. Velg markedsplass med `lang` og `country` (Amazon.com, Amazon.co.uk, Amazon.de, Amazon.co.jp m.fl.)
`ebay`	eBay-søkeforslag. Velg nettsted med `lang` og `country` (ebay.com, ebay.co.uk, ebay.de, ebay.fr m.fl.; `en`, `de`, `fr`, `it`, `es`, `nl`, `pl`)
`shopee`	Shopee-søkeforslag. Velg nettsted med `lang` og `country` (shopee.tw, shopee.sg, shopee.com.my, shopee.ph, shopee.co.id, shopee.vn, shopee.co.th, shopee.com.br m.fl.; `zh-tw`, `en`, `ms`, `fil`, `id`, `vi`, `th`, `pt`)
`duckduckgo`	DuckDuckGo-søkeforslag (`lang=ja` gir forslag for Japan)
`baidu`	Baidu-søkeforslag (`zh`, `ja`, `en`)
`yandex`	Yandex-søkeforslag (`ru`, `tr`, `kk`, `uz`)
`naver`	Naver-søkeforslag (`ko`)
`daum`	Daum-søkeforslag (`ko`)
`yahoo`	Søkeforslag fra Yahoo! JAPAN (bare Japan) · `zh-tw`: Yahoo奇摩 (Yahoo! Taiwan)
`rakuten`	Søkeforslag fra Rakuten Ichiba (bare Japan)

Parameter	Beskrivelse
`q` (påkrevd)	Søkeord (1–60 tegn). Tegn i full og halv bredde, store og små bokstaver og mellomrom normaliseres.
`lang`	`ja` (standard; beholdt av hensyn til eksisterende klienter, men angi det helst eksplisitt), `en`, `ru`, `ko`, `zh` og de andre språkkodene på nettstedet (50 i alt). `ja` utvides med kana (`nihongo`), andre språk med mellomrom pluss språkets egne bokstaver (`native`). `en` har ingen av delene.
`country`	Land/marked (valgfritt, ISO 3166-1 med 2 bokstaver). `en`: us (standard), gb, ca, au, in, ie, nz, sg, za, ph; `es`: es, mx, ar, co, cl, pe, us; `pt`: br, pt; `fr`: fr, ca, be, ch; `de`: de, at, ch; `zh-tw`: tw, hk m.fl. Gjelder Amazon (markedsplass), Bing, DuckDuckGo, Google og YouTube. Amazon, Bing og DuckDuckGo følger det valgte landet tett. Google og YouTube tilpasses også landet, men kan fortsatt være preget av hvor forespørselen sendes fra.
`group`	`all` (standard) eller en kommaseparert liste av `itself,nihongo,native,alphabet,number`.
`flat`	`1` returnerer én samlet `suggestions`-matrise uten duplikater.

Slik fungerer den asynkrone flyten

Det tar flere titalls sekunder å hente et søkeord som ikke er hentet før, så API-et svarer først med 202 og setter det i kø. Send den samme forespørselen på nytt etter retry_after_seconds; når dataene er klare, får du 200 med resultatene. Hentede data hurtigbufres i 7 dager. Når de er utløpt, returneres de gamle dataene med "stale": true mens de hentes på nytt. Hurtigbufferen er separat for hver kombinasjon av source, q og lang.

curl -H "Authorization: Bearer $KEY" \
  "https://gstudio1.com/api/v1/google/suggest?q=running%20shoes&lang=en&country=us&flat=1"

curl -H "Authorization: Bearer $KEY" \
  "https://gstudio1.com/api/v1/amazon/suggest?q=running%20shoes&lang=en&country=gb&flat=1"

// 202 (i kø)
{ "ok": true, "status": "queued", "source": "google", "lang": "en", "country": "us", "queue_position": 3, "retry_after_seconds": 24, ... }

// 200 (klar)
{ "ok": true, "status": "ready", "query": "running shoes", "source": "google", "lang": "en", "country": "us", "fetched_at": "2026-10-24T01:02:03Z",
  "stale": false, "count": 268, "suggestions": ["running shoes for women", "..."] }

Andre endepunkter

GET /api/v1/usage — Bruken av nøkkelen din de siste 30 dagene og grensene i planen din (krever autentisering)
GET /api/v1/status — Kølengde og status for workere (krever ikke autentisering)

Grenser (gratisplan)

Punkt	Grense
Forespørsler per minutt	30
Forespørsler per dag (UTC)	1,000
Nye (ikke hurtigbufrede) søkeord per dag	20 Telles per source. Søkeord som allerede er hentet, teller ikke.

Ved overskridelse returneres 429 med Retry-After. Alle svar inneholder X-RateLimit-Limit / Remaining / Reset og X-Daily-Limit / X-Daily-Remaining.

Feil

HTTP	code	Betydning
400	invalid_query / invalid_lang / invalid_country / invalid_group / source_not_offered	Ugyldig parameter (inkludert en `source` som ikke tilbys på det aktuelle språket)
401	invalid_api_key	Nøkkelen mangler eller er ugyldig
404	not_found	Ugyldig `source` eller sti
429	rate_limited / daily_quota_exceeded / new_keyword_quota_exceeded	Grensen er overskredet (se `Retry-After`)
502	upstream_failed	Hentingen mislyktes (kan prøves igjen etter 1 time)
503	queue_full	Overbelastet (se `Retry-After`)

Kontakt

Ønsker du høyere grenser eller kommersiell bruk, eller vil du rapportere en feil, kan du kontakte driftsansvarlig (Yuki Nakazawa) direkte på Telegram eller via DM på X. Vi svarer på japansk og engelsk.

Før du bruker API-et

Grensene for gratisplanen kan endres uten varsel. Betalte planer finner du på prissiden.
Dataene bygger på de offentlige søkeforslagssvarene fra hver tjeneste. Det gis ingen garanti for nøyaktighet eller kontinuitet (SLA).

Vilkår for bruk (på engelsk) · Personvernerklæring (på engelsk)