Google, Bing, YouTube, Amazon, eBay, Shopee, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver, Daum సూచనలను (విస్తరణతో సహా) సైట్‌లోని 50 భాషల్లో అందించే JSON API ఇది. జపనీస్‌కు あ–ん, A–Z, 0–9 విస్తరణ ఉంటుంది; ఇతర భాషలకు స్పేస్‌తో పాటు ఆ భాష సొంత అక్షరాలు (ఉదాహరణకు తెలుగులో అ–హ), A–Z, 0–9 విస్తరణ ఉంటుంది. ఉచిత ప్లాన్ నుంచే ఉపయోగించడం మొదలుపెట్టవచ్చు (ధరలు).
API కీ తప్పనిసరి. లాగిన్ అయిన తర్వాత యూజర్ మెనూలోని "API" నుంచి కీ పొందవచ్చు. ప్రతి అభ్యర్థనతో కీని పంపండి.
Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
కీని మీ సర్వర్ నుంచి మాత్రమే ఉపయోగించండి (బ్రౌజర్ 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! Taiwan |
rakuten | Rakuten Ichiba సూచనలు (జపాన్ కోసం) |
| పారామీటర్ | వివరణ |
|---|---|
q (తప్పనిసరి) | కీవర్డ్ (1–60 అక్షరాలు). ఫుల్-విడ్త్/హాఫ్-విడ్త్ అక్షరాలు, పెద్ద/చిన్న అక్షరాలు, స్పేస్‌లు నార్మలైజ్ చేయబడతాయి. |
lang | ja (డిఫాల్ట్; ఇప్పటికే వాడుతున్నవారి కోసం డిఫాల్ట్‌ను మార్చలేదు, కానీ స్పష్టంగా పేర్కొనడం మంచిది), en, ru, ko, zh వంటి సైట్‌లోని 50 భాషల కోడ్‌లు. ja జపనీస్ కానా అక్షరమాల (nihongo)తో, ఇతర భాషలు స్పేస్‌తో పాటు ఆ భాష సొంత అక్షరాల (native)తో విస్తరిస్తాయి. enకు కానా గానీ సొంత అక్షరాల విస్తరణ గానీ ఉండదు. |
country | దేశం / మార్కెట్ (ఐచ్ఛికం, ISO 3166-1 alpha-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 అర్రేగా అందిస్తుంది. |
ఇంకా సేకరించని కీవర్డ్‌ను పొందడానికి కొన్ని పదుల సెకన్లు పడుతుంది, కాబట్టి API ముందుగా 202 అందించి దాన్ని క్యూలో పెడుతుంది. retry_after_seconds తర్వాత అదే అభ్యర్థనను మళ్లీ పంపండి; డేటా సిద్ధంగా ఉంటే 200తో ఫలితాలు వస్తాయి. సేకరించిన డేటా 7 రోజులు కాష్‌లో ఉంటుంది; గడువు ముగిసిన తర్వాత మళ్లీ సేకరిస్తున్న సమయంలో పాత డేటా "stale": trueతో అందుతుంది. కాష్ 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 — గత 30 రోజుల్లో మీ కీ వినియోగం, ప్లాన్ పరిమితులు (ప్రామాణీకరణ అవసరం)GET /api/v1/status — క్యూ లోతు, వర్కర్‌ల స్థితి (ప్రామాణీకరణ అవసరం లేదు)| అంశం | పరిమితి |
|---|---|
| అభ్యర్థనలు/నిమిషం | 30 |
| అభ్యర్థనలు/రోజు (UTC) | 1,000 |
| కొత్త (కాష్‌లో లేని) కీవర్డ్‌లు/రోజు | 20 ※ source వారీగా లెక్కిస్తారు; ఇప్పటికే సేకరించిన కీవర్డ్‌లు లెక్కలోకి రావు |
పరిమితి దాటితే API 429, Retry-After అందిస్తుంది. ప్రతి రెస్పాన్స్‌లో 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 | కీ లేదు లేదా చెల్లదు |
| 404 | not_found | చెల్లని source లేదా పాత్ |
| 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 ద్వారా సంప్రదించండి. ఇంగ్లీష్ లేదా జపనీస్‌లో సమాధానం ఇస్తారు.