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奇摩 (Yahoo! Taiwan) |
rakuten | Rakuten Ichiba সাজেশন (শুধু জাপানের জন্য) |
| প্যারামিটার | বিবরণ |
|---|---|
q (আবশ্যক) | কিওয়ার্ড (1–60 অক্ষর)। ফুল-উইডথ/হাফ-উইডথ অক্ষর, বড়-ছোট হাতের অক্ষর ও স্পেস স্বাভাবিক রূপে আনা হয়। |
lang | ja (ডিফল্ট; বর্তমান ব্যবহারকারীদের জন্য ডিফল্ট বদলানো হয়নি, তবে স্পষ্টভাবে উল্লেখ করা ভালো), en, ru, ko, zh প্রভৃতি সাইটের 50টি ভাষার কোড। ja কানা বর্ণমালা (nihongo) দিয়ে, অন্য ভাষাগুলো স্পেস ও নিজস্ব অক্ষর (native) দিয়ে সম্প্রসারণ করে। en-এ কানা বা নিজস্ব অক্ষরের কোনো সম্প্রসারণ নেই। |
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 অ্যারে হিসেবে ফেরত দেয়। |
যে কিওয়ার্ড এখনো সংগ্রহ করা হয়নি, তা আনতে কিছুটা সময় (কখনো আধা মিনিটেরও বেশি) লাগে, তাই 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)