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奇摩 (तैवान) |
rakuten | Rakuten Ichiba सूचना (जपानसाठी) |
| पॅरामीटर | वर्णन |
|---|---|
q (आवश्यक) | कीवर्ड (1–60 अक्षरे). पूर्ण/अर्ध रुंदीची अक्षरे, कॅपिटल/स्मॉल अक्षरे आणि स्पेस सामान्यीकृत केले जातात. |
lang | ja (डीफॉल्ट; सध्याच्या क्लायंटसाठी बदललेले नाही, पण स्पष्टपणे देणे उत्तम), en, ru, ko, zh आणि साइटच्या इतर भाषांचे कोड (एकूण 50). ja चा विस्तार काना ने (nihongo) होतो, तर इतर भाषांचा स्पेस आणि त्यांच्या स्वतःच्या अक्षरांनी (native). en साठी काना किंवा स्वतःच्या अक्षरांचा विस्तार नाही. |
country | देश किंवा बाजारपेठ (ऐच्छिक; ISO 3166-1 नुसार दोन अक्षरी कोड). 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 द्वारे थेट संपर्क करा. आम्ही इंग्रजी किंवा जपानी भाषेत उत्तर देतो.