Google, Bing, YouTube, Amazon, eBay, Shopee, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver, Daum ஆகியவற்றின் தேடல் பரிந்துரைகளை (விரிவாக்கத்துடன்) தளத்தின் 50 மொழிகளில் தரும் JSON API இது. ஜப்பானிய மொழி கானா எழுத்துகள் (あ–ん), 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 இரண்டு எழுத்துக் குறியீடு). 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 — வரிசையின் நீளம், worker-களின் இயக்க நிலை (அங்கீகாரம் தேவையில்லை)| உருப்படி | வரம்பு |
|---|---|
| கோரிக்கைகள்/நிமிடம் | 30 |
| கோரிக்கைகள்/நாள் (UTC) | 1,000 |
| புதிய (கேஷ் செய்யப்படாத) முக்கியச் சொற்கள்/நாள் | 20 (source வாரியாகக் கணக்கிடப்படும்; ஏற்கெனவே பெறப்பட்ட முக்கியச் சொற்கள் கணக்கில் சேராது) |
வரம்பை மீறினால் 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 மூலம் நேரடியாகத் தொடர்புகொள்ளுங்கள். ஜப்பானிய, ஆங்கில மொழிகளில் பதிலளிக்கப்படும்.
சேவை விதிமுறைகள் (English) · தனியுரிமைக் கொள்கை (English)