Isang JSON API na nagbabalik ng mga search suggestion (kasama ang pagpapalawak) mula sa Google, Bing, YouTube, Amazon, eBay, Shopee, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver at Daum sa 50 wika ng site. Pinapalawak ang Japanese gamit ang kana (あ–ん), A–Z at 0–9, at ang ibang wika gamit ang space at ang sariling mga titik ng wika, A–Z at 0–9. Puwede kang magsimula sa libreng plano (presyo).
Kailangan ng API key. Mag-log in, at gumawa ng key mula sa “API” sa user menu. Isama ito sa bawat request.
Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Gamitin lang ang key mula sa server mo (kapag inilagay mo ito sa JavaScript ng browser, magagamit ito ng ibang tao).
Itakda ang {source} sa isa sa mga sumusunod.
| source | Kinukuha |
|---|---|
google | Mga search suggestion ng Google |
bing | Mga search suggestion ng Bing |
youtube | Mga search suggestion ng YouTube |
amazon | Mga search suggestion ng Amazon. Piliin ang marketplace gamit ang lang at country (Amazon.com, Amazon.co.uk, Amazon.de, Amazon.co.jp at iba pa) |
ebay | Mga search suggestion ng eBay. Piliin ang site gamit ang lang at country (ebay.com, ebay.co.uk, ebay.de, ebay.fr at iba pa; en, de, fr, it, es, nl, pl) |
shopee | Mga search suggestion ng Shopee. Piliin ang site gamit ang lang at country (shopee.tw, shopee.sg, shopee.com.my, shopee.ph, shopee.co.id, shopee.vn, shopee.co.th, shopee.com.br at iba pa; zh-tw, en, ms, fil, id, vi, th, pt) |
duckduckgo | Mga search suggestion ng DuckDuckGo (sa lang=ja, mga suggestion para sa Japan) |
baidu | Mga search suggestion ng Baidu (zh, ja, en) |
yandex | Mga search suggestion ng Yandex (ru, tr, kk, uz) |
naver | Mga search suggestion ng Naver (ko) |
daum | Mga search suggestion ng Daum (ko) |
yahoo | Mga search suggestion ng Yahoo! JAPAN (para sa Japan) · zh-tw: Yahoo奇摩 (Taiwan) |
rakuten | Mga search suggestion ng Rakuten Ichiba (para sa Japan) |
| Parameter | Paglalarawan |
|---|---|
q (kailangan) | Keyword (1–60 character). Ina-normalize ang full-width/half-width, malaki/maliit na titik at mga space. |
lang | ja (default; hindi binago para sa mga kasalukuyang user, pero mas mainam na itakda ito nang tahasan), en, ru, ko, zh at iba pang code ng 50 wika ng site. Pinapalawak ang ja gamit ang kana (nihongo), at ang ibang wika gamit ang space at ang sariling mga titik nito (native). Walang pagpapalawak gamit ang kana o sariling mga titik ang en. |
country | Bansa / merkado (opsyonal, ISO 3166-1 na may 2 titik). en: us (default), 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; at iba pa. Gumagana para sa Amazon (marketplace), Bing, DuckDuckGo, Google at YouTube. Mahigpit na sinusunod ng Amazon, Bing at DuckDuckGo ang itinakdang bansa. Iniaangkop din ng Google at YouTube sa bansa, pero maaaring may epekto pa rin ang lokasyon kung saan ipinadala ang request. |
group | all (default) o listahang pinaghihiwalay ng kuwit mula sa itself,nihongo,native,alphabet,number. |
flat | Sa 1, ibinabalik ang iisang suggestions array na walang duplicate. |
Ilang sampung segundo ang kailangan para makuha ang keyword na hindi pa nakukuha, kaya ibinabalik muna ng API ang 202 at inilalagay ito sa pila. Ipadala muli ang parehong request pagkalipas ng retry_after_seconds; kapag handa na ang data, makakatanggap ka ng 200 kasama ang data. Naka-cache nang 7 araw ang nakuhang data. Pagkatapos nitong mag-expire, ibinabalik pa rin ang lumang data na may "stale": true habang kinukuha itong muli. Hiwalay ang cache para sa bawat kombinasyon ng source, q at 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 (nasa pila)
{ "ok": true, "status": "queued", "source": "google", "lang": "en", "country": "us", "queue_position": 3, "retry_after_seconds": 24, ... }
// 200 (handa na)
{ "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", "..."] }
GET /api/v1/usage — Paggamit ng iyong key sa nakaraang 30 araw at mga limit ng iyong plano (kailangan ng authentication)GET /api/v1/status — Haba ng pila at status ng mga worker (hindi kailangan ng authentication)| Item | Limit |
|---|---|
| Request kada minuto | 30 |
| Request kada araw (UTC) | 1,000 |
| Bagong keyword (hindi pa naka-cache) kada araw | 20 Hiwalay na binibilang kada source. Hindi binibilang ang mga keyword na nakuha na. |
Kapag lumampas sa limit, ibinabalik ng API ang 429 kasama ang Retry-After. Kasama sa bawat response ang X-RateLimit-Limit / Remaining / Reset at X-Daily-Limit / X-Daily-Remaining.
| HTTP | code | Kahulugan |
|---|---|---|
| 400 | invalid_query / invalid_lang / invalid_country / invalid_group / source_not_offered | Hindi wastong parameter (kasama ang source na hindi available sa wikang iyon) |
| 401 | invalid_api_key | Walang key o hindi wasto ang key |
| 404 | not_found | Hindi wastong source o path |
| 429 | rate_limited / daily_quota_exceeded / new_keyword_quota_exceeded | Lumampas sa limit (tingnan ang Retry-After) |
| 502 | upstream_failed | Hindi nakuha ang data (puwedeng subukang muli pagkalipas ng isang oras) |
| 503 | queue_full | Abala ang server (tingnan ang Retry-After) |
Para sa mas mataas na limit, komersyal na paggamit o pag-uulat ng bug, direktang mag-message sa operator (Yuki Nakazawa) sa Telegram o sa DM sa X. Sumasagot kami sa Japanese at English.
Mga Tuntunin ng Serbisyo (English) · Patakaran sa Privacy (English)