આ 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奇摩 (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 માટે અલગ ગણતરી; પહેલેથી મેળવેલા કીવર્ડ ગણાતા નથી |
મર્યાદા વટાવતાં 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 પર સીધો સંપર્ક કરો. જવાબ અંગ્રેજી કે જાપાનીમાં મળશે.