यह एक JSON API है जो Google, Bing, YouTube, Amazon, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver और Daum के सर्च सुझाव (ऑटोकम्प्लीट) विस्तार सहित साइट की सभी 20 भाषाओं में लौटाती है। जापानी का विस्तार काना (あ–ん), A–Z और 0–9 से होता है; बाकी भाषाओं का विस्तार स्पेस के साथ उस भाषा के अपने अक्षरों, A–Z और 0–9 से। आप मुफ़्त प्लान से शुरू कर सकते हैं (मूल्य)।
API कुंजी (key) ज़रूरी है। लॉग इन करने के बाद यूज़र मेन्यू के "API" से कुंजी बनाएं। हर अनुरोध के साथ यह कुंजी भेजें।
Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
कुंजी का उपयोग केवल अपने सर्वर से करें। ब्राउज़र के JavaScript में डालने पर दूसरे लोग इसका उपयोग कर सकते हैं।
{source} में इनमें से कोई एक मान दें।
| source | क्या लौटाता है |
|---|---|
google | Google सुझाव |
bing | Bing सुझाव |
youtube | YouTube सुझाव |
amazon | Amazon सुझाव (ja: Amazon.co.jp; अन्य भाषाएँ: उस भाषा का मुख्य मार्केटप्लेस) |
rakuten | Rakuten Ichiba (जापान) सुझाव |
yahoo | Yahoo! Search सुझाव |
duckduckgo | DuckDuckGo सुझाव (lang=ja पर जापान के लिए सुझाव) |
baidu | Baidu सुझाव (zh, zh-tw, ja, en) |
yandex | Yandex सुझाव (ru, uk, tr) |
naver | Naver सुझाव (ko) |
daum | Daum सुझाव (ko) |
| पैरामीटर | विवरण |
|---|---|
q (ज़रूरी) | कीवर्ड (1–60 अक्षर)। फ़ुल-विड्थ/हाफ़-विड्थ अक्षर, बड़े/छोटे अक्षर और स्पेस नॉर्मलाइज़ किए जाते हैं। |
lang | ja (डिफ़ॉल्ट), en, ru, ko, zh और साइट के बाकी भाषा कोड (कुल 20)। ja काना विस्तार (nihongo) जोड़ता है; बाकी भाषाएँ स्पेस के साथ अपने अक्षर (native) जोड़ती हैं। en में इनमें से कोई नहीं है। |
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=%E3%83%A9%E3%83%B3%E3%83%8B%E3%83%B3%E3%82%B0&flat=1" curl -H "Authorization: Bearer $KEY" \ "https://gstudio1.com/api/v1/rakuten/suggest?q=%E3%83%A9%E3%83%B3%E3%83%8B%E3%83%B3%E3%82%B0&flat=1"
// 202 (कतार में)
{ "ok": true, "status": "queued", "source": "google", "queue_position": 3, "retry_after_seconds": 24, ... }
// 200 (तैयार)
{ "ok": true, "status": "ready", "query": "ランニング", "source": "google", "fetched_at": "2026-09-19T01:02:03Z",
"stale": false, "count": 412, "suggestions": ["ランニング シューズ", "..."] }
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_group | अमान्य पैरामीटर (उस भाषा के लिए उपलब्ध न होने वाला 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 देखें) |
सेवा की शर्तें (English) · गोपनीयता नीति (English)