API v1

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

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

Endpoints

POST/api/v1/keywords/ideasKredit: 2

Ide 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 }
POST/api/v1/keywords/volumeKredit: 1 per 10 kata kunci

Volume pencarian bulanan dan metrik untuk maksimal 100 kata kunci.

{ "keywords": ["seo tools", "keyword research"], "country": "us" }
GET/api/v1/keywords/suggest?keyword=seo&lang=en&country=us&sources=google,youtube&modes=az,questionsKredit: 1

Saran autocomplete dari Google, YouTube, Bing, Amazon, Yahoo, Yandex, dan Wikipedia. modes: az, questions, comparisons, prepositions, numbers.

POST/api/v1/keywords/groupKredit: 1

Kelompokkan hingga 500 kata kunci menjadi grup.

{ "keywords": "seo tools\nfree seo tools\nkeyword planner" }
POST/api/v1/keywords/semanticKredit: 2

Kata kunci semantik buatan AI untuk sebuah topik.

{ "keyword": "coffee machine", "lang": "en" }
GET/api/v1/usageKredit: 0

Paket 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

HTTPerrorArti
401UNAUTHORIZEDAPI key tidak ada, tidak valid, atau sudah dicabut
400INVALID_INPUTBody atau query request tidak valid
429QUOTA_EXCEEDEDKredit bulan ini sudah habis
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_UNAVAILABLESumber 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.