API วิจัยคีย์เวิร์ด
ไอเดียคีย์เวิร์ด ปริมาณการค้นหา CPC ความยากของคีย์เวิร์ด คำแนะนำอัตโนมัติ และการจัดกลุ่ม สำหรับเครื่องมือ แดชบอร์ด และ AI agent ของคุณเอง ทุก endpoint ส่งคืน JSON และใช้คำขอรายเดือนของแพ็กเกจร่วมกับเว็บไซต์
เริ่มต้นอย่างรวดเร็ว
ปริมาณการค้นหาของสองคีย์เวิร์ดในเวียดนาม ในสามภาษา:
curl -X POST https://keywordplanner.vn/api/v1/keywords/volume \
-H "Authorization: Bearer kwp_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "keywords": ["seo tools", "keyword research"], "country": "vn" }'const res = await fetch("https://keywordplanner.vn/api/v1/keywords/volume", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.KWP_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({ keywords: ["seo tools", "keyword research"], country: "vn" }),
});
const { ok, data, usage } = await res.json();import os, requests
r = requests.post(
"https://keywordplanner.vn/api/v1/keywords/volume",
headers={"Authorization": f"Bearer {os.environ['KWP_API_KEY']}"},
json={"keywords": ["seo tools", "keyword research"], "country": "vn"},
timeout=60,
)
print(r.json()["data"]["keywords"])การยืนยันตัวตน
สร้างคีย์ใน Dashboard API และส่งไปใน header Authorization
curl https://keywordplanner.vn/api/v1/usage \ -H "Authorization: Bearer kwp_live_YOUR_KEY"
ขีดจำกัด
- Starter: 10,000 เครดิต / เดือน ($9, ใช้ร่วมกับเว็บไซต์)
- Pro: 25,000 เครดิต / เดือน ($19, ใช้ร่วมกับเว็บไซต์)
- แพ็กเกจฟรีและ Lite ไม่รวม API
- Starter และ Pro: สูงสุด 10% ของเครดิตรายเดือนต่อวัน, 15 ครั้งต่อนาที และ 5 คำขอพร้อมกัน
- Response header:
X-Plan,X-Requests-Limit-Month,X-Requests-Remaining-Month,Retry-After
Endpoints
/api/v1/keywords/ideasเครดิต: 2ไอเดียคีย์เวิร์ดจากคีย์เวิร์ดตั้งต้นและ/หรือเว็บไซต์ พร้อมปริมาณการค้นหา แนวโน้ม 12 เดือน CPC การแข่งขัน และความยาก (สูงสุด 1000 แถว)
{ "keywords": ["keyword planner"], "country": "vn", "lang": "vi", "targetSite": "example.com", "sortBy": "resultDESC", "limit": 200 }/api/v1/keywords/volumeเครดิต: 1 ต่อ 10 คีย์เวิร์ดปริมาณการค้นหารายเดือนและตัวชี้วัดสำหรับคีย์เวิร์ดสูงสุด 100 คำ
{ "keywords": ["seo tools", "keyword research"], "country": "us" }/api/v1/keywords/suggest?keyword=seo&lang=en&country=us&sources=google,youtube&modes=az,questionsเครดิต: 1คำแนะนำอัตโนมัติจาก Google, YouTube, Bing, Amazon, Yahoo, Yandex และ Wikipedia modes: az, questions, comparisons, prepositions, numbers
/api/v1/keywords/groupเครดิต: 1จัดกลุ่มคีย์เวิร์ดสูงสุด 500 คำ
{ "keywords": "seo tools\nfree seo tools\nkeyword planner" }/api/v1/keywords/semanticเครดิต: 2คีย์เวิร์ดเชิงความหมายที่ AI สร้างสำหรับหัวข้อหนึ่ง
{ "keyword": "coffee machine", "lang": "en" }/api/v1/usageเครดิต: 0แพ็กเกจปัจจุบันและเครดิตที่เหลือ (ไม่ใช้เครดิต)
ผลลัพธ์ที่ส่งคืน
{
"ok": true,
"data": {
"keywords": [
{ "keyword": "keyword planner", "results": 12100, "trend": [9900, 12100, …], "competition_level": 34,
"minCPC": 4200, "maxCPC": 15800, "difficulty": 48.2, "length": 2, "isQuestion": false, "keywordType": "exact" }
],
"traffic": [{ "time": "2026-09", "month": 9, "year": 2026, "totalImpression": 154000 }]
},
"usage": { "plan": "Starter", "units": 2, "used": 121, "limit": 10000, "remaining": 9879 }
}ค่า CPC เป็นสกุล VND ส่วน trend มีข้อมูล 12 เดือน เรียงจากเก่าสุดก่อน
ข้อผิดพลาด
| HTTP | error | ความหมาย |
|---|---|---|
| 401 | UNAUTHORIZED | API key หายไป ไม่ถูกต้อง หรือถูกเพิกถอน |
| 400 | INVALID_INPUT | ข้อมูล request body หรือ query ไม่ถูกต้อง |
| 429 | QUOTA_EXCEEDED | ใช้เครดิตของเดือนนี้ครบแล้ว |
| 403 | PLAN_NO_API | Your plan does not include the API (Lite) |
| 429 | DAILY_LIMIT | Daily API limit reached |
| 429 | RATE_LIMITED | Too many calls this minute (or free plan spacing): wait `Retry-After` seconds |
| 429 | TOO_MANY_CONCURRENT | More than 5 requests at the same time |
| 503 | SOURCE_UNAVAILABLE | แหล่งข้อมูลคีย์เวิร์ดไม่พร้อมใช้งานชั่วคราว |
คำถามที่พบบ่อย
แพ็กเกจใดมี API?
Starter และ Pro API ใช้เครดิตรายเดือนเดียวกับเว็บไซต์ จึงไม่ต้องสมัคร API แยก แพ็กเกจฟรีและ Lite ไม่รวม API
การเรียกแต่ละครั้งใช้กี่เครดิต?
ไอเดียคีย์เวิร์ดและคีย์เวิร์ดเชิงความหมายนับ 2 เครดิต ปริมาณการค้นหา 1 เครดิตต่อ 10 คีย์เวิร์ด คำแนะนำและการจัดกลุ่ม 1 เครดิต /api/v1/usage และการเรียกที่ล้มเหลวจะไม่ถูกนับ
รองรับประเทศและภาษาใดบ้าง?
ทุกประเทศและภาษาของแหล่งข้อมูลคีย์เวิร์ด: ส่งรหัส ISO ใน country (vn, us, jp…) และ lang (vi, en, ja…) ค่า CPC ส่งคืนเป็นสกุล VND
มีการจำกัดอัตราคำขอหรือไม่?
มี: 15 ครั้งต่อนาที, 5 คำขอพร้อมกัน และสูงสุด 10% ของเครดิตรายเดือนต่อวัน header Retry-After จะบอกว่าต้องรอนานเท่าใด
ฉันมี API key หลายคีย์ได้ไหม?
ได้ สูงสุด 5 คีย์ต่อบัญชี (เช่น หนึ่งคีย์ต่อแอป) สร้างได้ใน แดชบอร์ด › API เพิกถอนคีย์ได้ทุกเมื่อ คีย์อื่นยังทำงานตามปกติ