API v1

API วิจัยคีย์เวิร์ด

ไอเดียคีย์เวิร์ด ปริมาณการค้นหา CPC ความยากของคีย์เวิร์ด คำแนะนำอัตโนมัติ และการจัดกลุ่ม สำหรับเครื่องมือ แดชบอร์ด และ AI agent ของคุณเอง ทุก endpoint ส่งคืน JSON และใช้คำขอรายเดือนของแพ็กเกจร่วมกับเว็บไซต์

เริ่มต้นอย่างรวดเร็ว

ปริมาณการค้นหาของสองคีย์เวิร์ดในเวียดนาม ในสามภาษา:

cURL
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" }'
JavaScript
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();
Python
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"

ขีดจำกัด

Endpoints

POST/api/v1/keywords/ideasเครดิต: 2

ไอเดียคีย์เวิร์ดจากคีย์เวิร์ดตั้งต้นและ/หรือเว็บไซต์ พร้อมปริมาณการค้นหา แนวโน้ม 12 เดือน CPC การแข่งขัน และความยาก (สูงสุด 1000 แถว)

{ "keywords": ["keyword planner"], "country": "vn", "lang": "vi", "targetSite": "example.com", "sortBy": "resultDESC", "limit": 200 }
POST/api/v1/keywords/volumeเครดิต: 1 ต่อ 10 คีย์เวิร์ด

ปริมาณการค้นหารายเดือนและตัวชี้วัดสำหรับคีย์เวิร์ดสูงสุด 100 คำ

{ "keywords": ["seo tools", "keyword research"], "country": "us" }
GET/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

POST/api/v1/keywords/groupเครดิต: 1

จัดกลุ่มคีย์เวิร์ดสูงสุด 500 คำ

{ "keywords": "seo tools\nfree seo tools\nkeyword planner" }
POST/api/v1/keywords/semanticเครดิต: 2

คีย์เวิร์ดเชิงความหมายที่ AI สร้างสำหรับหัวข้อหนึ่ง

{ "keyword": "coffee machine", "lang": "en" }
GET/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 เดือน เรียงจากเก่าสุดก่อน

ข้อผิดพลาด

HTTPerrorความหมาย
401UNAUTHORIZEDAPI key หายไป ไม่ถูกต้อง หรือถูกเพิกถอน
400INVALID_INPUTข้อมูล request body หรือ query ไม่ถูกต้อง
429QUOTA_EXCEEDEDใช้เครดิตของเดือนนี้ครบแล้ว
403PLAN_NO_APIYour plan does not include the API (Lite)
429DAILY_LIMITDaily API limit reached
429RATE_LIMITEDToo many calls this minute (or free plan spacing): wait `Retry-After` seconds
429TOO_MANY_CONCURRENTMore than 5 requests at the same time
503SOURCE_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 เพิกถอนคีย์ได้ทุกเมื่อ คีย์อื่นยังทำงานตามปกติ