Suggest API v1

Et JSON-API, der leverer søgeforslag (inklusive udvidelser) fra Google, Bing, YouTube, Amazon, eBay, Shopee, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver og Daum på sitets 50 sprog. Japansk udvides med kana (あ–ん), A–Z og 0–9, de øvrige sprog med mellemrum plus sprogets egne bogstaver (fx æ ø å på dansk), A–Z og 0–9. Du kan starte med den gratis plan (priser).

Godkendelse

Der kræves en API-nøgle. Log ind, og opret en nøgle under »API« i brugermenuen. Send den med i alle forespørgsler.

Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Brug kun nøglen fra din server. Hvis du lægger den ind i JavaScript i browseren, kan andre bruge den.

GET /api/v1/{source}/suggest

Sæt {source} til en af følgende værdier.

source	Leverer
`google`	Google-søgeforslag
`bing`	Bing-søgeforslag
`youtube`	YouTube-søgeforslag
`amazon`	Amazon-søgeforslag. Vælg markedsplads med `lang` og `country` (Amazon.com, Amazon.co.uk, Amazon.de, Amazon.co.jp m.fl.)
`ebay`	eBay-søgeforslag. Vælg side 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øgeforslag. Vælg side 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øgeforslag (`lang=ja` giver forslag til Japan)
`baidu`	Baidu-søgeforslag (`zh`, `ja`, `en`)
`yandex`	Yandex-søgeforslag (`ru`, `tr`, `kk`, `uz`)
`naver`	Naver-søgeforslag (`ko`)
`daum`	Daum-søgeforslag (`ko`)
`yahoo`	Søgeforslag fra Yahoo! JAPAN (kun Japan) · `zh-tw`: Yahoo奇摩 (Yahoo! Taiwan)
`rakuten`	Søgeforslag fra Rakuten Ichiba (kun Japan)

Parameter	Beskrivelse
`q` (påkrævet)	Søgeord (1–60 tegn). Tegn i fuld og halv bredde, store og små bogstaver samt mellemrum normaliseres.
`lang`	`ja` (standard; bevaret af hensyn til eksisterende klienter, men angiv det helst eksplicit), `en`, `ru`, `ko`, `zh` og de øvrige sprogkoder på sitet (50 i alt). `ja` udvides med kana (`nihongo`), andre sprog med mellemrum plus sprogets egne bogstaver (`native`). `en` har ingen af delene.
`country`	Land/marked (valgfrit, ISO 3166-1 med 2 bogstaver). `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. Gælder for Amazon (markedsplads), Bing, DuckDuckGo, Google og YouTube. Amazon, Bing og DuckDuckGo følger det valgte land nøje. Google og YouTube tilpasses også landet, men kan stadig være præget af, hvor forespørgslen sendes fra.
`group`	`all` (standard) eller en kommasepareret liste af `itself,nihongo,native,alphabet,number`.
`flat`	`1` returnerer ét samlet `suggestions`-array uden dubletter.

Sådan fungerer det asynkrone flow

Det tager nogle snese sekunder at hente et søgeord, der ikke er hentet før, så API'et svarer først med 202 og sætter det i kø. Send den samme forespørgsel igen efter retry_after_seconds; når dataene er klar, får du 200 med resultaterne. Hentede data caches i 7 dage. Når de er udløbet, returneres de gamle data med "stale": true, mens de hentes på ny. Cachen er separat for hver kombination af 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 endpoints

GET /api/v1/usage — Forbruget for din nøgle de seneste 30 dage og din plans grænser (kræver godkendelse)
GET /api/v1/status — Kølængde og status for workers (kræver ikke godkendelse)

Grænser (gratis plan)

Punkt	Grænse
Forespørgsler pr. minut	30
Forespørgsler pr. dag (UTC)	1,000
Nye (ikke-cachede) søgeord pr. dag	20 Tælles pr. source. Søgeord, der allerede er hentet, tæller ikke.

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

Fejl

HTTP	code	Betydning
400	invalid_query / invalid_lang / invalid_country / invalid_group / source_not_offered	Ugyldig parameter (herunder en `source`, der ikke tilbydes på det pågældende sprog)
401	invalid_api_key	Nøglen mangler eller er ugyldig
404	not_found	Ugyldig `source` eller sti
429	rate_limited / daily_quota_exceeded / new_keyword_quota_exceeded	Grænse overskredet (se `Retry-After`)
502	upstream_failed	Hentningen mislykkedes (kan prøves igen efter 1 time)
503	queue_full	Overbelastet (se `Retry-After`)

Kontakt

Ønsker du højere grænser eller kommerciel brug, eller vil du rapportere en fejl, så skriv direkte til den driftsansvarlige (Yuki Nakazawa) på Telegram eller som DM på X. Vi svarer på japansk og engelsk.

Før du bruger API'et

Grænserne for den gratis plan kan ændres uden varsel. Betalte planer finder du på prissiden.
Dataene bygger på de offentlige søgeforslagssvar fra hver tjeneste. Der gives ingen garanti for nøjagtighed eller kontinuitet (SLA).

Vilkår for brug (på engelsk) · Privatlivspolitik (på engelsk)