Google, Bing, YouTube, Amazon, eBay, Shopee, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver va Daum qidiruv takliflarini (kengaytirish bilan) saytning 50 tilida qaytaradigan JSON API. Yapon tili yapon kana boʻgʻin yozuvi (あ–ん), A–Z va 0–9 bilan, boshqa tillar esa boʻsh joy, tilning oʻz harflari (masalan, rus tilida а–я), A–Z va 0–9 bilan kengaytiriladi. Bepul tarifdan boshlashingiz mumkin (narxlar).
API kaliti talab qilinadi. Tizimga kirganingizdan soʻng foydalanuvchi menyusidagi “API” boʻlimidan kalit yaratishingiz mumkin. Uni har bir soʻrov bilan yuboring.
Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Kalitdan faqat server tomonida foydalaning (brauzerdagi JavaScript kodiga joylasangiz, uni begonalar ishlatib qoʻyishi mumkin).
{source} oʻrniga quyidagi qiymatlardan birini koʻrsating.
| source | Manba |
|---|---|
google | Google takliflari |
bing | Bing takliflari |
youtube | YouTube takliflari |
amazon | Amazon takliflari. Bozor lang va country orqali tanlanadi (Amazon.com, Amazon.co.uk, Amazon.de, Amazon.co.jp va boshqalar) |
ebay | eBay takliflari. Sayt lang va country orqali tanlanadi (ebay.com, ebay.co.uk, ebay.de, ebay.fr va boshqalar; en, de, fr, it, es, nl, pl) |
shopee | Shopee takliflari. Sayt lang va country orqali tanlanadi (shopee.tw, shopee.sg, shopee.com.my, shopee.ph, shopee.co.id, shopee.vn, shopee.co.th, shopee.com.br va boshqalar; zh-tw, en, ms, fil, id, vi, th, pt) |
duckduckgo | DuckDuckGo takliflari (lang=ja Yaponiya uchun takliflarni qaytaradi) |
baidu | Baidu takliflari (zh, ja, en) |
yandex | Yandex takliflari (ru, tr, kk, uz) |
naver | Naver takliflari (ko) |
daum | Daum takliflari (ko) |
yahoo | Yahoo! JAPAN qidiruv takliflari (Yaponiya uchun); zh-tw uchun – Yahoo奇摩 (Tayvan) |
rakuten | Rakuten Ichiba takliflari (Yaponiya uchun) |
| Parametr | Tavsif |
|---|---|
q (majburiy) | Kalit soʻz (1–60 belgi). Toʻliq va yarim kenglikdagi belgilar, katta-kichik harflar va boʻsh joylar normallashtiriladi. |
lang | ja (standart qiymat; mavjud mijozlar uchun oʻzgartirilmagan, lekin aniq koʻrsatish tavsiya etiladi), en, ru, ko, zh va saytning boshqa til kodlari (jami 50 ta). ja kana bilan (nihongo), boshqa tillar boʻsh joy va oʻz harflari bilan (native) kengaytiriladi. en uchun na kana, na oʻz harflari bilan kengaytirish bor. |
country | Mamlakat yoki bozor (ixtiyoriy; ISO 3166-1 boʻyicha ikki harfli kod). en: us (standart), 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 va boshqalar. Amazon (bozor), Bing, DuckDuckGo, Google va YouTube uchun amal qiladi. Amazon, Bing va DuckDuckGo koʻrsatilgan mamlakatga aniq amal qiladi. Google va YouTube ham mamlakatga moslashadi, biroq natijalarda soʻrov yuborilayotgan hududning taʼsiri qolishi mumkin. |
group | all (standart) yoki itself,nihongo,native,alphabet,number qiymatlarining vergul bilan ajratilgan roʻyxati. |
flat | 1 boʻlsa, takrorlarsiz yagona suggestions massivini qaytaradi. |
Keshda hali yoʻq kalit soʻzni olish bir necha oʻn soniya vaqt oladi, shuning uchun API avval 202 qaytarib, uni navbatga qoʻyadi. retry_after_seconds oʻtgach, aynan oʻsha soʻrovni qayta yuboring: maʼlumotlar tayyor boʻlsa, natijalar bilan 200 olasiz. Olingan maʼlumotlar 7 kun keshda saqlanadi; muddati tugagach, qayta olinayotgan vaqtda eski maʼlumotlar "stale": true belgisi bilan qaytariladi. Kesh source, q va lang birikmasi boʻyicha alohida yuritiladi.
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 (navbatda)
{ "ok": true, "status": "queued", "source": "google", "lang": "en", "country": "us", "queue_position": 3, "retry_after_seconds": 24, ... }
// 200 (tayyor)
{ "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 — Kalitingizning oxirgi 30 kundagi ishlatilishi va tarif limitlari (autentifikatsiya talab qilinadi)GET /api/v1/status — Navbat uzunligi va ishlov beruvchi jarayonlar holati (autentifikatsiyasiz)| Koʻrsatkich | Limit |
|---|---|
| Soʻrov/daqiqa | 30 |
| Soʻrov/kun (UTC) | 1,000 |
| Yangi (keshda yoʻq) kalit soʻzlar/kun | 20 * Har bir source uchun alohida hisoblanadi; avval olingan kalit soʻzlar hisobga kirmaydi |
Limit oshib ketsa, API 429 va Retry-After qaytaradi. Har bir javobda X-RateLimit-Limit / Remaining / Reset va X-Daily-Limit / X-Daily-Remaining boʻladi.
| HTTP | code | Maʼnosi |
|---|---|---|
| 400 | invalid_query / invalid_lang / invalid_country / invalid_group / source_not_offered | Notoʻgʻri parametr (shu tilda taklif etilmaydigan source ham kiradi) |
| 401 | invalid_api_key | Kalit yoʻq yoki yaroqsiz |
| 404 | not_found | Notoʻgʻri source yoki yoʻl |
| 429 | rate_limited / daily_quota_exceeded / new_keyword_quota_exceeded | Limit oshib ketdi (Retry-After ga qarang) |
| 502 | upstream_failed | Olib boʻlmadi (1 soatdan keyin qayta urinish mumkin) |
| 503 | queue_full | Band (Retry-After ga qarang) |
Limitlarni oshirish, tijoriy foydalanish yoki xatolar haqida xabar berish uchun xizmat egasiga (Yuki Nakazawa) Telegram yoki X shaxsiy xabari orqali bevosita yozing. Ingliz yoki yapon tilida javob beramiz.