یہ ایک JSON API ہے جو Google، Bing، YouTube، Amazon، eBay، Shopee، Rakuten Ichiba، Yahoo!، DuckDuckGo، Baidu، Yandex، Naver اور Daum کی سرچ تجاویز (توسیع سمیت) سائٹ کی 50 زبانوں میں فراہم کرتا ہے۔ جاپانی میں جاپانی کانا (あ–ん)، 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 array کی شکل میں واپس آتے ہیں۔ |
جو کی ورڈ ابھی حاصل نہیں کیا گیا اسے حاصل کرنے میں دسیوں سیکنڈ لگتے ہیں، اس لیے 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 کے لیے الگ شمار ہوتے ہیں؛ پہلے سے حاصل شدہ کی ورڈز شمار نہیں ہوتے) |
حد سے تجاوز پر 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 پر رابطہ کریں۔ جواب جاپانی اور انگریزی میں دیا جاتا ہے۔
شرائطِ استعمال (English) · پرائیویسی پالیسی (English)