Google၊ Bing၊ YouTube၊ Amazon၊ eBay၊ Shopee၊ Rakuten Ichiba၊ Yahoo!၊ DuckDuckGo၊ Baidu၊ Yandex၊ Naver နှင့် Daum ၏ အကြံပြုချက်များ (ချဲ့ထွင်ခြင်း အပါအဝင်) ကို ဆိုက်၏ ဘာသာစကား 50 ဖြင့် ပြန်ပေးသော JSON API ဖြစ်ပါသည်။ ဂျပန်ဘာသာကို kana (あ–ん)၊ A–Z နှင့် 0–9 ဖြင့်၊ အခြားဘာသာစကားများကို ကွက်လပ်နှင့် ထိုဘာသာစကား၏ ကိုယ်ပိုင်စာလုံးများ (ဥပမာ မြန်မာဘာသာတွင် က–အ)၊ A–Z နှင့် 0–9 ဖြင့် ချဲ့ထွင်ပါသည်။ အခမဲ့အစီအစဉ်ဖြင့် စတင်အသုံးပြုနိုင်ပါသည် (ဈေးနှုန်း)။
API key မဖြစ်မနေ လိုအပ်ပါသည်။ ဝင်ရောက်ပြီးနောက် အသုံးပြုသူမီနူးရှိ “API” မှ API key ကို ထုတ်ယူနိုင်ပါသည်။ တောင်းဆိုမှုတိုင်းတွင် ထည့်သွင်းပေးပို့ပါ။
Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
API key ကို ဆာဗာဘက်မှသာ အသုံးပြုပါ (ဘရောက်ဇာ၏ JavaScript ထဲတွင် ထည့်ထားပါက အခြားသူများ အသုံးပြုသွားနိုင်ပါသည်)။
{source} တွင် အောက်ပါတို့အနက် တစ်ခုကို သတ်မှတ်ပါ။
| source | ရယူမည့် အရာ |
|---|---|
google | Google အကြံပြုချက်များ |
bing | Bing အကြံပြုချက်များ |
youtube | YouTube အကြံပြုချက်များ |
amazon | Amazon အကြံပြုချက်များ။ lang နှင့် country ဖြင့် ဈေးကွက်ကို ရွေးနိုင်ပါသည် (Amazon.com၊ Amazon.co.uk၊ Amazon.de၊ Amazon.co.jp စသည်) |
ebay | eBay အကြံပြုချက်များ။ lang နှင့် country ဖြင့် ဆိုက်ကို ရွေးနိုင်ပါသည် (ebay.com၊ ebay.co.uk၊ ebay.de၊ ebay.fr စသည်။ en, de, fr, it, es, nl, pl) |
shopee | Shopee အကြံပြုချက်များ။ lang နှင့် country ဖြင့် ဆိုက်ကို ရွေးနိုင်ပါသည် (shopee.tw၊ shopee.sg၊ shopee.com.my၊ shopee.ph၊ shopee.co.id၊ shopee.vn၊ shopee.co.th၊ shopee.com.br စသည်။ zh-tw, en, ms, fil, id, vi, th, pt) |
duckduckgo | DuckDuckGo အကြံပြုချက်များ (lang=ja ဖြစ်ပါက ဂျပန်အတွက် အကြံပြုချက်များ) |
baidu | Baidu အကြံပြုချက်များ (zh, ja, en) |
yandex | Yandex အကြံပြုချက်များ (ru, tr, kk, uz) |
naver | Naver အကြံပြုချက်များ (ko) |
daum | Daum အကြံပြုချက်များ (ko) |
yahoo | Yahoo! JAPAN ရှာဖွေမှု အကြံပြုချက်များ (ဂျပန်အတွက်) · zh-tw တွင် Yahoo奇摩 (ထိုင်ဝမ်) |
rakuten | Rakuten Ichiba အကြံပြုချက်များ (ဂျပန်အတွက်) |
| ပါရာမီတာ | ဖော်ပြချက် |
|---|---|
q (မဖြစ်မနေ) | သော့ချက်စာလုံး (စာလုံး 1–60)။ full-width/half-width၊ စာလုံးအကြီးအသေးနှင့် ကွက်လပ်များကို စံပုံစံသို့ ပြောင်းပေးပါသည်။ |
lang | ja (မူလတန်ဖိုး။ လက်ရှိအသုံးပြုသူများအတွက် မပြောင်းလဲထားသော်လည်း တိတိကျကျ သတ်မှတ်ရန် အကြံပြုပါသည်)၊ en, ru, ko, zh စသည့် ဆိုက်၏ ဘာသာစကား 50 ၏ ကုဒ်များ။ ja ကို ဂျပန် kana (nihongo) ဖြင့်၊ အခြားဘာသာစကားများကို ကွက်လပ်နှင့် ထိုဘာသာစကား၏ စာလုံးများ (native) ဖြင့် ချဲ့ထွင်ပါသည်။ en တွင် kana နှင့် ကိုယ်ပိုင်စာလုံး ချဲ့ထွင်ခြင်း မရှိပါ။ |
country | နိုင်ငံ / ဈေးကွက် (ရွေးချယ်နိုင်၊ ISO 3166-1 စာလုံး 2 လုံး)။ en: us (မူလ), 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 စသည်။ Amazon (ဈေးကွက်)၊ Bing၊ DuckDuckGo၊ Google နှင့် YouTube တွင် သက်ရောက်ပါသည်။ Amazon၊ Bing နှင့် DuckDuckGo သည် သတ်မှတ်ထားသော နိုင်ငံအတိုင်း တင်းကျပ်စွာ လိုက်နာပါသည်။ Google နှင့် YouTube သည်လည်း နိုင်ငံအလိုက် ချိန်ညှိသော်လည်း တောင်းဆိုမှု ပို့သည့် ဒေသ၏ သက်ရောက်မှု ကျန်ရှိနိုင်ပါသည်။ |
group | all (မူလတန်ဖိုး) သို့မဟုတ် itself,nihongo,native,alphabet,number ကို ကော်မာဖြင့် ခြားထားသော စာရင်း။ |
flat | 1 ဖြစ်ပါက ထပ်နေသည်များကို ဖယ်ရှားထားသော suggestions array တစ်ခုတည်းအဖြစ် ပြန်ပေးပါသည်။ |
မရယူရသေးသော သော့ချက်စာလုံးကို ရယူရန် စက္ကန့် ဆယ်ချီ ကြာသဖြင့် ပထမဦးစွာ 202 ကို ပြန်ပေးပြီး တန်းစီထဲသို့ ထည့်ပါသည်။ retry_after_seconds ကြာပြီးနောက် တူညီသော တောင်းဆိုမှု ကို ပြန်ပို့ပါက ရယူပြီးဖြစ်လျှင် 200 ဖြင့် ဒေတာကို ပြန်ပေးပါသည်။ ရယူပြီးသော ဒေတာကို 7 ရက် cache ထားပြီး သက်တမ်းကုန်ပြီးနောက် ပြန်လည်ရယူနေစဉ်အတွင်း ဒေတာဟောင်းကို "stale": true ဖြင့် ပြန်ပေးပါသည်။ cache သည် source၊ q နှင့် 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 (တန်းစီပြီး)
{ "ok": true, "status": "queued", "source": "google", "lang": "en", "country": "us", "queue_position": 3, "retry_after_seconds": 24, ... }
// 200 (ရယူပြီး)
{ "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 — သင့် API key ၏ ပြီးခဲ့သော 30 ရက် အသုံးပြုမှုနှင့် အစီအစဉ် ကန့်သတ်ချက် (အထောက်အထား စိစစ်ရန် လိုအပ်)GET /api/v1/status — တန်းစီ အရေအတွက်နှင့် worker အခြေအနေ (အထောက်အထား စိစစ်ရန် မလို)| အကြောင်းအရာ | ကန့်သတ်ချက် |
|---|---|
| တောင်းဆိုမှု/မိနစ် | 30 |
| တောင်းဆိုမှု/ရက် (UTC) | 1,000 |
| သော့ချက်စာလုံးအသစ် (cache မရှိသေး)/ရက် | 20 (source အလိုက် သီးခြားရေတွက်ပြီး ရယူပြီးသား သော့ချက်စာလုံးများကို မရေတွက်ပါ) |
ကန့်သတ်ချက် ကျော်လွန်ပါက 429 နှင့် Retry-After ကို ပြန်ပေးပါသည်။ response တိုင်းတွင် X-RateLimit-Limit / Remaining / Reset နှင့် X-Daily-Limit / X-Daily-Remaining ပါဝင်ပါသည်။
| HTTP | code | အဓိပ္ပာယ် |
|---|---|---|
| 400 | invalid_query / invalid_lang / invalid_country / invalid_group / source_not_offered | ပါရာမီတာ မမှန်ကန်ပါ (ထိုဘာသာစကားတွင် မပေးဆောင်သော source အပါအဝင်) |
| 401 | invalid_api_key | API key မပါ သို့မဟုတ် မမှန်ကန်ပါ |
| 404 | not_found | source သို့မဟုတ် path မမှန်ကန်ပါ |
| 429 | rate_limited / daily_quota_exceeded / new_keyword_quota_exceeded | ကန့်သတ်ချက် ကျော်လွန်သည် (Retry-After ကို ကြည့်ပါ) |
| 502 | upstream_failed | ရယူမှု မအောင်မြင်ပါ (1 နာရီအကြာတွင် ထပ်မံကြိုးစားနိုင်သည်) |
| 503 | queue_full | အလုပ်များနေသည် (Retry-After ကို ကြည့်ပါ) |
ကန့်သတ်ချက် တိုးမြှင့်ခြင်း၊ စီးပွားဖြစ် အသုံးပြုခြင်းဆိုင်ရာ တိုင်ပင်ဆွေးနွေးမှုနှင့် ချို့ယွင်းချက် အစီရင်ခံခြင်းအတွက် လည်ပတ်သူ (Yuki Nakazawa) ထံ Telegram သို့မဟုတ် X DM ဖြင့် တိုက်ရိုက် ဆက်သွယ်ပါ။ အင်္ဂလိပ် သို့မဟုတ် ဂျပန်ဘာသာဖြင့် ပြန်လည်ဖြေကြားပါသည်။