Suggest API v1

Ett JSON-API som returnerar sökförslag (med utökning) från Google, Bing, YouTube, Amazon, eBay, Shopee, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver och Daum på webbplatsens 50 språk. Japanska utökas med kana (あ–ん), A–Z och 0–9, övriga språk med mellanslag, språkets egna bokstäver (på svenska å ä ö), A–Z och 0–9. Du kan börja med gratisplanen (priser).

Autentisering

En API-nyckel krävs. Logga in och skapa en nyckel under ”API” i användarmenyn. Skicka den med varje anrop.

Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Använd nyckeln endast från din server. Om du bäddar in den i JavaScript i webbläsaren kan andra använda den.

GET /api/v1/{source}/suggest

Ange något av följande som {source}.

source	Returnerar
`google`	Sökförslag från Google
`bing`	Sökförslag från Bing
`youtube`	Sökförslag från YouTube
`amazon`	Sökförslag från Amazon, från den marknadsplats du väljer med `lang` och `country` (Amazon.com, Amazon.co.uk, Amazon.de, Amazon.co.jp med flera)
`ebay`	Sökförslag från eBay, från den sajt du väljer med `lang` och `country` (ebay.com, ebay.co.uk, ebay.de, ebay.fr med flera; `en`, `de`, `fr`, `it`, `es`, `nl`, `pl`)
`shopee`	Sökförslag från Shopee, från den sajt du väljer med `lang` och `country` (shopee.tw, shopee.sg, shopee.com.my, shopee.ph, shopee.co.id, shopee.vn, shopee.co.th, shopee.com.br med flera; `zh-tw`, `en`, `ms`, `fil`, `id`, `vi`, `th`, `pt`)
`duckduckgo`	Sökförslag från DuckDuckGo (`lang=ja` ger förslag för Japan)
`baidu`	Sökförslag från Baidu (`zh`, `ja`, `en`)
`yandex`	Sökförslag från Yandex (`ru`, `tr`, `kk`, `uz`)
`naver`	Sökförslag från Naver (`ko`)
`daum`	Sökförslag från Daum (`ko`)
`yahoo`	Sökförslag från Yahoo! JAPAN (endast Japan) · `zh-tw`: Yahoo奇摩 (Yahoo! Taiwan)
`rakuten`	Sökförslag från Rakuten Ichiba (endast Japan)

Parameter	Beskrivning
`q` (obligatorisk)	Sökord (1–60 tecken). Tecken med hel och halv bredd, versaler/gemener och mellanslag normaliseras.
`lang`	`ja` (standard, behålls av hänsyn till befintliga användare, men ange gärna språket uttryckligen), `en`, `ru`, `ko`, `zh` och webbplatsens övriga språkkoder (50 totalt). `ja` lägger till kana-utökning (`nihongo`), övriga språk mellanslag och egna bokstäver (`native`). `en` har ingen av dem.
`country`	Land/marknad (valfritt, ISO 3166-1 alpha-2). `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 med flera. Gäller Amazon (marknadsplats), Bing, DuckDuckGo, Google och YouTube. Amazon, Bing och DuckDuckGo följer landet noga; Google och YouTube anpassas också, men kan fortfarande påverkas av varifrån anropet skickas.
`group`	`all` (standard) eller en kommaseparerad lista med `itself,nihongo,native,alphabet,number`.
`flat`	`1` returnerar en enda `suggestions`-array utan dubbletter.

Så fungerar det asynkrona flödet

Att hämta ett sökord som inte redan är cachat tar några tiotal sekunder, så API:et svarar först med 202 och lägger sökordet i kö. Skicka samma anrop igen efter retry_after_seconds; när datan är klar får du 200 med resultaten. Hämtad data cachas i 7 dagar. När den har gått ut returneras den gamla datan med "stale": true medan den uppdateras. Cachen är separat för varje kombination av source, q och 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", "..."] }

Övriga endpoints

GET /api/v1/usage — Din nyckels användning de senaste 30 dagarna och planens gränser (autentisering krävs)
GET /api/v1/status — Kölängd och workerstatus (ingen autentisering)

Gränser (gratisplan)

Post	Gräns
Anrop per minut	30
Anrop per dag (UTC)	1,000
Nya (ej cachade) sökord per dag	20 Räknas per source. Sökord som redan är hämtade räknas inte.

När en gräns överskrids svarar API:et med 429 och Retry-After. Varje svar innehåller X-RateLimit-Limit / Remaining / Reset och X-Daily-Limit / X-Daily-Remaining.

Fel

HTTP	code	Betydelse
400	invalid_query / invalid_lang / invalid_country / invalid_group / source_not_offered	Ogiltig parameter (även en `source` som inte erbjuds för språket)
401	invalid_api_key	Nyckel saknas eller är ogiltig
404	not_found	Ogiltig `source` eller sökväg
429	rate_limited / daily_quota_exceeded / new_keyword_quota_exceeded	Gräns överskriden (se `Retry-After`)
502	upstream_failed	Hämtningen misslyckades (kan göras om efter en timme)
503	queue_full	Hög belastning (se `Retry-After`)

Kontakt

För högre gränser, kommersiell användning eller felrapporter kan du skriva direkt till den som driver tjänsten (Yuki Nakazawa) på Telegram eller via DM på X. Svar ges på engelska eller japanska.

Innan du använder API:et

Gratisplanens gränser kan ändras utan förvarning. Betalplanerna finns på prissidan.
Datan bygger på de offentliga sökförslagssvaren från respektive tjänst. Korrekthet och kontinuitet (SLA) garanteras inte.

Användarvillkor (på engelska) · Integritetspolicy (på engelska)