Keyword Research API

Keyword ideas, search volume, CPC, keyword difficulty, autocomplete suggestions and clustering for your own tools, dashboards and AI agents. All endpoints return JSON and use the monthly requests of your plan, shared with the website.

Quick start

Search volume for two keywords in Vietnam, in three languages:

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

Authentication

Create a key in Dashboard API and send it in the Authorization header.

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

Limits

• Starter: 10,000 credits / month ($9, shared with the website)
• Pro: 25,000 credits / month ($19, shared with the website)
• Free and Lite do not include the API.
• Starter and Pro: at most 10% of the monthly credits a day, 15 calls a minute and 5 requests at the same time.
• Response headers: 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" }

Response

{
  "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 values are in VND. trend holds 12 months, oldest first.

Errors

Frequently Asked Questions