Google, Bing, YouTube, Amazon, eBay, Shopee, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver və Daum axtarış təkliflərini (genişləndirmə ilə birlikdə) saytın 50 dilində qaytaran JSON API. Yapon dili yapon kana heca yazısı (あ–ん), A–Z və 0–9 ilə, digər dillər isə boşluq, dilin öz hərfləri (məsələn, Azərbaycan dilində ç ə ğ ı ö ş ü), A–Z və 0–9 ilə genişləndirilir. Pulsuz tariflə başlaya bilərsiniz (qiymətlər).
API açarı tələb olunur. Daxil olduqdan sonra istifadəçi menyusundakı «API» bölməsindən açar yarada bilərsiniz. Onu hər sorğu ilə göndərin.
Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Açardan yalnız server tərəfində istifadə edin (brauzerdəki JavaScript koduna yerləşdirsəniz, başqaları ondan istifadə edə bilər).
{source} üçün aşağıdakı dəyərlərdən birini göstərin.
| source | Mənbə |
|---|---|
google | Google təklifləri |
bing | Bing təklifləri |
youtube | YouTube təklifləri |
amazon | Amazon təklifləri. Bazar lang və country ilə seçilir (Amazon.com, Amazon.co.uk, Amazon.de, Amazon.co.jp və s.) |
ebay | eBay təklifləri. Sayt lang və country ilə seçilir (ebay.com, ebay.co.uk, ebay.de, ebay.fr və s.; en, de, fr, it, es, nl, pl) |
shopee | Shopee təklifləri. Sayt lang və country ilə seçilir (shopee.tw, shopee.sg, shopee.com.my, shopee.ph, shopee.co.id, shopee.vn, shopee.co.th, shopee.com.br və s.; zh-tw, en, ms, fil, id, vi, th, pt) |
duckduckgo | DuckDuckGo təklifləri (lang=ja Yaponiya üçün təkliflər qaytarır) |
baidu | Baidu təklifləri (zh, ja, en) |
yandex | Yandex təklifləri (ru, tr, kk, uz) |
naver | Naver təklifləri (ko) |
daum | Daum təklifləri (ko) |
yahoo | Yahoo! JAPAN axtarış təklifləri (Yaponiya üçün); zh-tw üçün – Yahoo奇摩 (Tayvan) |
rakuten | Rakuten Ichiba təklifləri (Yaponiya üçün) |
| Parametr | Təsvir |
|---|---|
q (məcburi) | Açar söz (1–60 simvol). Tam və yarım enli simvollar, böyük və kiçik hərflər, boşluqlar normallaşdırılır. |
lang | ja (standart dəyər; mövcud müştərilər üçün dəyişdirilməyib, lakin açıq göstərmək tövsiyə olunur), en, ru, ko, zh və saytın digər dil kodları (cəmi 50). ja kana ilə (nihongo), digər dillər boşluq və öz hərfləri ilə (native) genişləndirilir. en üçün nə kana, nə də öz hərfləri ilə genişləndirmə var. |
country | Ölkə və ya bazar (istəyə görə; ISO 3166-1 üzrə iki hərfli 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 və s. Amazon (bazar), Bing, DuckDuckGo, Google və YouTube üçün keçərlidir. Amazon, Bing və DuckDuckGo göstərilən ölkəyə dəqiq əməl edir. Google və YouTube da ölkəyə uyğunlaşır, lakin nəticələrdə sorğunun göndərildiyi regionun təsiri qala bilər. |
group | all (standart) və ya itself,nihongo,native,alphabet,number dəyərlərinin vergüllə ayrılmış siyahısı. |
flat | 1 olduqda təkrarsız vahid suggestions massivi qaytarır. |
Keşdə hələ olmayan açar sözün alınması onlarla saniyə çəkir, buna görə də API əvvəlcə 202 qaytarır və onu növbəyə qoyur. retry_after_seconds keçdikdən sonra eyni sorğunu yenidən göndərin: məlumatlar hazırdırsa, nəticələrlə birlikdə 200 alırsınız. Alınmış məlumatlar 7 gün keşdə saxlanılır; müddət bitdikdən sonra yenidən alınarkən köhnə məlumatlar "stale": true ilə qaytarılır. Keş hər source, q və lang birləşməsi üçün ayrıca aparılır.
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 (növbədə)
{ "ok": true, "status": "queued", "source": "google", "lang": "en", "country": "us", "queue_position": 3, "retry_after_seconds": 24, ... }
// 200 (hazır)
{ "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 — Açarınızın son 30 gündə istifadəsi və tarif limitləri (autentifikasiya tələb olunur)GET /api/v1/status — Növbənin uzunluğu və emal proseslərinin vəziyyəti (autentifikasiyasız)| Göstərici | Limit |
|---|---|
| Sorğu/dəqiqə | 30 |
| Sorğu/gün (UTC) | 1,000 |
| Yeni (keşdə olmayan) açar sözlər/gün | 20 * Hər source üçün ayrıca hesablanır; artıq alınmış açar sözlər hesaba düşmür |
Limit aşıldıqda API 429 və Retry-After qaytarır. Hər cavabda X-RateLimit-Limit / Remaining / Reset və X-Daily-Limit / X-Daily-Remaining olur.
| HTTP | code | Mənası |
|---|---|---|
| 400 | invalid_query / invalid_lang / invalid_country / invalid_group / source_not_offered | Yanlış parametr (həmin dildə təklif olunmayan source da daxil olmaqla) |
| 401 | invalid_api_key | Açar yoxdur və ya etibarsızdır |
| 404 | not_found | Yanlış source və ya yol |
| 429 | rate_limited / daily_quota_exceeded / new_keyword_quota_exceeded | Limit aşılıb (Retry-After baxın) |
| 502 | upstream_failed | Alınmadı (1 saatdan sonra yenidən cəhd etmək olar) |
| 503 | queue_full | Sistem məşğuldur (Retry-After baxın) |
Limitlərin artırılması, kommersiya istifadəsi və ya xəta bildirişləri üçün xidmətin sahibinə (Yuki Nakazawa) Telegram və ya X şəxsi mesajı ilə birbaşa yazın. İngilis və ya yapon dilində cavab veririk.