API Nghiên Cứu Từ Khóa

Ý tưởng từ khóa, lượng tìm kiếm, CPC, độ khó, gợi ý tự động và gom nhóm cho công cụ, dashboard và AI agent của bạn. Mọi endpoint trả JSON và dùng chung lượt hằng tháng của gói với website.

Bắt đầu nhanh

Lấy lượng tìm kiếm của hai từ khóa tại Việt Nam, bằng ba ngôn ngữ lập trình:

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"])

Xác thực

Tạo key trong Dashboard API và gửi kèm trong header Authorization.

curl https://keywordplanner.vn/api/v1/usage \
  -H "Authorization: Bearer kwp_live_YOUR_KEY"

Giới hạn

• Starter: 10,000 credit / tháng ($9, dùng chung với website)
• Pro: 25,000 credit / tháng ($19, dùng chung với website)
• Gói Miễn phí và Lite không có API.
• Starter và Pro: tối đa 10% số credit của tháng mỗi ngày, 15 lần gọi mỗi phút và 5 lượt gọi cùng lúc.
• Header trả về: X-Plan, X-Requests-Limit-Month, X-Requests-Remaining-Month, Retry-After

Endpoints

{ "keywords": ["keyword planner"], "country": "vn", "lang": "vi", "targetSite": "example.com", "sortBy": "resultDESC", "limit": 200 }

{ "keywords": ["seo tools", "keyword research"], "country": "us" }

{ "keywords": "seo tools\nfree seo tools\nkeyword planner" }

{ "keyword": "coffee machine", "lang": "en" }

Kết quả trả về

{
  "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 tính bằng VND. trend gồm 12 tháng, cũ nhất trước.

Mã lỗi

Các câu hỏi thường gặp