JSON API ที่ส่งคืนคำแนะนำการค้นหา (autocomplete) ของ Google, Bing, YouTube, Amazon, Rakuten Ichiba, Yahoo!, DuckDuckGo, Baidu, Yandex, Naver และ Daum พร้อมคำที่ขยายแล้ว ในทั้ง 20 ภาษาของเว็บไซต์ ภาษาญี่ปุ่นขยายด้วยตัวอักษรคานะ (あ–ん), 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 (ja: Amazon.co.jp; ภาษาอื่น: มาร์เก็ตเพลสหลักของภาษานั้น) |
rakuten | คำแนะนำของ Rakuten Ichiba (ญี่ปุ่น) |
yahoo | คำแนะนำของ Yahoo! Search |
duckduckgo | คำแนะนำของ DuckDuckGo (lang=ja จะได้คำแนะนำสำหรับญี่ปุ่น) |
baidu | คำแนะนำของ Baidu (zh, zh-tw, ja, en) |
yandex | คำแนะนำของ Yandex (ru, uk, tr) |
naver | คำแนะนำของ Naver (ko) |
daum | คำแนะนำของ Daum (ko) |
| พารามิเตอร์ | คำอธิบาย |
|---|---|
q (จำเป็น) | คีย์เวิร์ด (1–60 ตัวอักษร) ระบบจะปรับอักขระเต็มความกว้าง/ครึ่งความกว้าง ตัวพิมพ์ใหญ่-เล็ก และช่องว่างให้เป็นรูปแบบมาตรฐาน |
lang | ja (ค่าเริ่มต้น), en, ru, ko, zh และรหัสภาษาอื่น ๆ ของเว็บไซต์ (รวม 20 ภาษา) ja จะเพิ่มการขยายด้วยคานะ (nihongo) ส่วนภาษาอื่นจะเพิ่มช่องว่างร่วมกับตัวอักษรของภาษานั้น (native) en ไม่มีการขยายทั้งสองแบบ |
group | all (ค่าเริ่มต้น) หรือรายการคั่นด้วยจุลภาคจาก itself,nihongo,native,alphabet,number |
flat | 1 จะส่งคืนเป็นอาร์เรย์ suggestions เดียวที่ตัดรายการซ้ำออกแล้ว |
คีย์เวิร์ดที่ยังไม่เคยดึงข้อมูลต้องใช้เวลาหลายสิบวินาที API จึงส่งคืน 202 ก่อนและนำคีย์เวิร์ดเข้าคิว ให้ส่งคำขอเดิมอีกครั้งหลังผ่านไป retry_after_seconds วินาที หากดึงข้อมูลเสร็จแล้วจะได้ 200 พร้อมข้อมูล ข้อมูลที่ดึงแล้วจะถูกแคชไว้ 7 วัน หลังหมดอายุ ระหว่างที่กำลังดึงข้อมูลใหม่ API จะส่งข้อมูลเก่าพร้อม "stale": true แคชแยกกันตามชุดค่า source, q และ lang
curl -H "Authorization: Bearer $KEY" \ "https://gstudio1.com/api/v1/google/suggest?q=%E3%83%A9%E3%83%B3%E3%83%8B%E3%83%B3%E3%82%B0&flat=1" curl -H "Authorization: Bearer $KEY" \ "https://gstudio1.com/api/v1/rakuten/suggest?q=%E3%83%A9%E3%83%B3%E3%83%8B%E3%83%B3%E3%82%B0&flat=1"
// 202 (เข้าคิวแล้ว)
{ "ok": true, "status": "queued", "source": "google", "queue_position": 3, "retry_after_seconds": 24, ... }
// 200 (พร้อมแล้ว)
{ "ok": true, "status": "ready", "query": "ランニング", "source": "google", "fetched_at": "2026-09-19T01:02:03Z",
"stale": false, "count": 412, "suggestions": ["ランニング シューズ", "..."] }
GET /api/v1/usage — การใช้งานคีย์ของคุณในช่วง 30 วันที่ผ่านมาและขีดจำกัดของแพ็กเกจ (ต้องยืนยันตัวตน)GET /api/v1/status — ความยาวคิวและสถานะการทำงานของ worker (ไม่ต้องยืนยันตัวตน)| รายการ | ขีดจำกัด |
|---|---|
| คำขอต่อนาที | 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_group | พารามิเตอร์ไม่ถูกต้อง (รวมถึง 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) |
ข้อกำหนดการให้บริการ (English) · นโยบายความเป็นส่วนตัว (English)