キーワードリサーチAPI

キーワード候補、検索ボリューム、CPC、キーワード難易度、オートコンプリート候補、グループ化を独自のツール、ダッシュボード、AIエージェントで利用できます。すべてのエンドポイントはJSONを返し、ウェブサイトと共有するプランの月間リクエストを使用します。

クイックスタート

ベトナムでの2つのキーワードの検索ボリューム（3つの言語で）:

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

認証

キーは Dashboard API で作成し、Authorizationヘッダーで送信してください。

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

制限

• Starter: 10,000 クレジット / 月 ($9, ウェブサイトと共有)
• Pro: 25,000 クレジット / 月 ($19, ウェブサイトと共有)
• FreeとLiteにはAPIは含まれていません。
• StarterとPro: 1日あたり月間クレジットの最大10%、1分あたり15回、同時実行5リクエストまで。
• レスポンスヘッダー: 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" }

レスポンス

{
  "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か月分のデータが入ります。

エラー

よくあるご質問