API Riset Kata Kunci
Ide kata kunci, volume pencarian, CPC, tingkat kesulitan kata kunci, saran autocomplete, dan pengelompokan untuk alat, dashboard, dan agen AI Anda sendiri. Semua endpoint mengembalikan JSON dan memakai request bulanan paket Anda, dibagi dengan situs web.
Mulai cepat
Volume pencarian untuk dua kata kunci di Vietnam, dalam tiga bahasa:
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"])Autentikasi
Buat key di Dashboard API lalu kirimkan di header Authorization.
curl https://keywordplanner.vn/api/v1/usage \ -H "Authorization: Bearer kwp_live_YOUR_KEY"
Batasan
- Starter: 10,000 kredit / bulan ($9, dibagi dengan situs web)
- Pro: 25,000 kredit / bulan ($19, dibagi dengan situs web)
- Paket Gratis dan Lite tidak termasuk API.
- Starter dan Pro: maksimal 10% kredit bulanan per hari, 15 panggilan per menit, dan 5 request sekaligus.
- Header respons:
X-Plan,X-Requests-Limit-Month,X-Requests-Remaining-Month,Retry-After
Endpoints
/api/v1/keywords/ideasKredit: 2Ide kata kunci untuk kata kunci awal dan/atau situs web, dengan volume, tren 12 bulan, CPC, persaingan, dan tingkat kesulitan (maks. 1000 baris).
{ "keywords": ["keyword planner"], "country": "vn", "lang": "vi", "targetSite": "example.com", "sortBy": "resultDESC", "limit": 200 }/api/v1/keywords/volumeKredit: 1 per 10 kata kunciVolume pencarian bulanan dan metrik untuk maksimal 100 kata kunci.
{ "keywords": ["seo tools", "keyword research"], "country": "us" }/api/v1/keywords/suggest?keyword=seo&lang=en&country=us&sources=google,youtube&modes=az,questionsKredit: 1Saran autocomplete dari Google, YouTube, Bing, Amazon, Yahoo, Yandex, dan Wikipedia. modes: az, questions, comparisons, prepositions, numbers.
/api/v1/keywords/groupKredit: 1Kelompokkan hingga 500 kata kunci menjadi grup.
{ "keywords": "seo tools\nfree seo tools\nkeyword planner" }/api/v1/keywords/semanticKredit: 2Kata kunci semantik buatan AI untuk sebuah topik.
{ "keyword": "coffee machine", "lang": "en" }/api/v1/usageKredit: 0Paket saat ini dan sisa kredit (tidak memakai kredit).
Respons
{
"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 }
}Nilai CPC dalam VND. trend berisi 12 bulan, dari yang terlama.
Error
| HTTP | error | Arti |
|---|---|---|
| 401 | UNAUTHORIZED | API key tidak ada, tidak valid, atau sudah dicabut |
| 400 | INVALID_INPUT | Body atau query request tidak valid |
| 429 | QUOTA_EXCEEDED | Kredit bulan ini sudah habis |
| 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 | Sumber data kata kunci sedang tidak tersedia |
Pertanyaan yang Sering Diajukan
Paket mana yang termasuk API?
Starter dan Pro. API memakai kredit bulanan yang sama dengan website, jadi tidak ada langganan API terpisah. Free dan Lite tidak termasuk API.
Berapa kredit yang dipakai satu panggilan?
Ide kata kunci dan kata kunci semantik dihitung 2 kredit, volume pencarian 1 per 10 kata kunci, saran dan pengelompokan 1. /api/v1/usage dan panggilan yang gagal tidak dihitung.
Negara dan bahasa apa saja yang didukung?
Semua negara dan bahasa dari sumber data kata kunci: kirim kode ISO di country (vn, us, jp…) dan lang (vi, en, ja…). Nilai CPC dikembalikan dalam VND.
Apakah ada batas kecepatan?
Ya: 15 panggilan per menit, 5 request sekaligus, dan maksimal 10% kredit bulanan per hari. Header Retry-After memberi tahu berapa lama harus menunggu.
Bisakah saya memiliki beberapa API key?
Bisa, hingga 5 key per akun (misalnya satu per aplikasi), dibuat di Dashboard › API. Cabut key kapan saja; key lainnya tetap berfungsi.