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 без повторения. |
Извличането на ключова дума, която още не е в кеша, отнема десетки секунди, затова 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. Отговаряме на английски или японски.