키워드 리서치 API

내 도구, 대시보드, AI 에이전트를 위한 키워드 아이디어, 검색량, CPC, 키워드 난이도, 자동완성 추천 및 그룹화. 모든 엔드포인트는 JSON을 반환하며 웹사이트와 공유하는 플랜의 월간 요청을 사용합니다.

빠른 시작

베트남에서 두 키워드의 검색량을 세 가지 언어로 조회하기:

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: 하루 최대 월간 크레딧의 10%, 분당 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개월 데이터를 오래된 순으로 담고 있습니다.

오류

자주 묻는 질문