API JSON care returnează sugestiile de căutare (inclusiv extinderile) de la Google, Bing, YouTube, Amazon, eBay, Shopee, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver și Daum, în cele 50 de limbi ale site-ului. Japoneza este extinsă cu silabarul kana (あ–ん), A–Z și 0–9, iar celelalte limbi cu spațiu și literele proprii ale fiecărei limbi, A–Z și 0–9. Puteți începe cu planul gratuit (prețuri).
Este necesară o cheie API. Autentificați-vă, apoi generați o cheie din „API”, în meniul utilizatorului. Trimiteți-o cu fiecare cerere.
Authorization: Bearer gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Folosiți cheia doar de pe server (dacă o includeți în JavaScript-ul din browser, o pot folosi alte persoane).
Înlocuiți {source} cu una dintre valorile următoare.
| source | Sursă |
|---|---|
google | Sugestii Google |
bing | Sugestii Bing |
youtube | Sugestii YouTube |
amazon | Sugestii Amazon. Alegeți piața cu lang și country (Amazon.com, Amazon.co.uk, Amazon.de, Amazon.co.jp și altele) |
ebay | Sugestii eBay. Alegeți site-ul cu lang și country (ebay.com, ebay.co.uk, ebay.de, ebay.fr și altele; en, de, fr, it, es, nl, pl) |
shopee | Sugestii Shopee. Alegeți site-ul cu lang și country (shopee.tw, shopee.sg, shopee.com.my, shopee.ph, shopee.co.id, shopee.vn, shopee.co.th, shopee.com.br și altele; zh-tw, en, ms, fil, id, vi, th, pt) |
duckduckgo | Sugestii DuckDuckGo (lang=ja returnează sugestii pentru Japonia) |
baidu | Sugestii Baidu (zh, ja, en) |
yandex | Sugestii Yandex (ru, tr, kk, uz) |
naver | Sugestii Naver (ko) |
daum | Sugestii Daum (ko) |
yahoo | Sugestii de căutare Yahoo! JAPAN (pentru Japonia) · zh-tw: Yahoo奇摩 (Taiwan) |
rakuten | Sugestii Rakuten Ichiba (pentru Japonia) |
| Parametru | Descriere |
|---|---|
q (obligatoriu) | Cuvântul cheie (1–60 de caractere). Caracterele full-width/half-width, majusculele/minusculele și spațiile sunt normalizate. |
lang | ja (implicit; păstrat pentru clienții existenți, dar vă recomandăm să îl specificați explicit), en, ru, ko, zh și celelalte coduri ale celor 50 de limbi ale site-ului. ja se extinde cu silabarul kana (nihongo), iar celelalte limbi cu spațiu și literele proprii (native). en nu are nici extindere kana, nici litere proprii. |
country | Țara / piața (opțional, cod ISO 3166-1 din 2 litere). en: us (implicit), 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; și altele. Se aplică pentru Amazon (piață), Bing, DuckDuckGo, Google și YouTube. Amazon, Bing și DuckDuckGo respectă strict țara indicată. Google și YouTube se adaptează și ele la țară, dar rezultatele pot fi influențate în continuare de locul din care este trimisă cererea. |
group | all (implicit) sau o listă separată prin virgule din itself,nihongo,native,alphabet,number. |
flat | 1 returnează un singur tablou suggestions, fără duplicate. |
Preluarea unui cuvânt cheie care nu este încă în cache durează câteva zeci de secunde, așa că API-ul returnează mai întâi 202 și îl pune în coadă. Trimiteți din nou aceeași cerere după retry_after_seconds; dacă datele sunt gata, primiți 200 cu datele. Datele preluate rămân în cache 7 zile. După expirare, datele vechi sunt returnate cu "stale": true cât timp sunt preluate din nou. Cache-ul este separat pentru fiecare combinație de source, q și 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 (în coadă)
{ "ok": true, "status": "queued", "source": "google", "lang": "en", "country": "us", "queue_position": 3, "retry_after_seconds": 24, ... }
// 200 (gata)
{ "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 — Utilizarea cheii dumneavoastră în ultimele 30 de zile și limitele planului (necesită autentificare)GET /api/v1/status — Lungimea cozii și starea workerilor (fără autentificare)| Element | Limită |
|---|---|
| Cereri pe minut | 30 |
| Cereri pe zi (UTC) | 1,000 |
| Cuvinte cheie noi (care nu sunt în cache) pe zi | 20 Se numără separat pentru fiecare source. Cuvintele cheie deja preluate nu se numără. |
La depășirea unei limite, API-ul returnează 429 cu Retry-After. Fiecare răspuns include X-RateLimit-Limit / Remaining / Reset și X-Daily-Limit / X-Daily-Remaining.
| HTTP | code | Semnificație |
|---|---|---|
| 400 | invalid_query / invalid_lang / invalid_country / invalid_group / source_not_offered | Parametru invalid (inclusiv un source care nu este oferit pentru limba respectivă) |
| 401 | invalid_api_key | Cheie lipsă sau invalidă |
| 404 | not_found | source sau cale invalidă |
| 429 | rate_limited / daily_quota_exceeded / new_keyword_quota_exceeded | Limită depășită (vedeți Retry-After) |
| 502 | upstream_failed | Preluare eșuată (puteți reîncerca după o oră) |
| 503 | queue_full | Server aglomerat (vedeți Retry-After) |
Pentru limite mai mari, utilizare comercială sau raportarea erorilor, scrieți-i direct operatorului (Yuki Nakazawa) pe Telegram sau prin mesaj direct pe X. Răspundem în japoneză și engleză.
Termeni și condiții (English) · Politica de confidențialitate (English)