키워드마스터 API 사용 가이드
검색부터 챌린지 운영까지 자동화

API로 무엇을 할 수 있나요?

키워드마스터 API는 웹사이트에서 하던 작업을 외부 프로그램·자동화 도구(MAKE.COM, n8n, 파이썬 스크립트 등)에서 그대로 실행할 수 있게 해줍니다. 크게 두 갈래입니다.

• 키워드 API — 단일/대량 키워드의 네이버 검색량·CPC·블로그 발행량 조회, 비싼키워드 수집.
• 키마비키 챌린지 API (플래티넘 이상) — 챌린지 참가, 배정 키워드 조회, 결과물 URL·수익 인증 제출, 점수/랭킹 확인을 모두 자동화.

1단계 · API 키 발급

1. 마이페이지 → API 메뉴로 이동합니다. (바로가기)
2. 키 이름(예: "자동화 서버")을 입력하고 [API 키 생성]을 누릅니다.
3. 생성된 키를 복사해 안전한 곳에 보관합니다. 키는 비밀번호와 같으니 외부에 노출하지 마세요.

키에는 플랜에 따라 권한(스코프)이 자동 부여됩니다. 플래티넘 키에는 challenge 스코프가 포함되어 챌린지 API를 바로 쓸 수 있습니다.

2단계 · 첫 호출 (키워드 검색)

모든 요청은 https://keywordmaster.net/api/v2/ 에 ?action= 으로 기능을 지정하고, X-API-Key 헤더로 인증합니다.

curl -H "X-API-Key: 발급받은_키" \
  "https://keywordmaster.net/api/v2/?action=search&keyword=키마비키"

3단계 · 키마비키 챌린지 운영 (플래티넘+)

챌린지는 "참가 → 매일 배정 키워드 확인 → 결과물 제출 → 점수 확인"의 흐름입니다. API로 이 전 과정을 자동화할 수 있습니다.

① 챌린지 참가

curl -X POST -H "X-API-Key: 키" -H "Content-Type: application/json" \
  -d '{"season_type":"7day"}' \
  "https://keywordmaster.net/api/v2/?action=challenge.join"

season_type 은 3day(작심3일) · 7day(도전7일) · 15day(보름달뜨는날) 중 선택합니다.

② 오늘 배정된 키워드 확인

curl -H "X-API-Key: 키" \
  "https://keywordmaster.net/api/v2/?action=challenge.keywords"

③ 결과물 URL 제출 (+수익 인증)

curl -X POST -H "X-API-Key: 키" -H "Content-Type: application/json" \
  -d '{"keyword_id":1234,"url":"https://blog.example.com/post","income_amount":120000}' \
  "https://keywordmaster.net/api/v2/?action=challenge.submit"

제출하면 XP가 적립되고(제출 +10, 수익 인증 보너스 최대 +100) AI 평가 큐에 등록됩니다.

④ 현황·랭킹 확인

curl -H "X-API-Key: 키" "https://keywordmaster.net/api/v2/?action=challenge.status"
curl -H "X-API-Key: 키" "https://keywordmaster.net/api/v2/?action=challenge.ranking&limit=20"

파이썬으로 한 번에

import requests
BASE="https://keywordmaster.net/api/v2/"
H={"X-API-Key":"발급받은_키","Content-Type":"application/json"}

requests.post(BASE, params={"action":"challenge.join"}, headers=H, json={"season_type":"7day"})
kw = requests.get(BASE, params={"action":"challenge.keywords"}, headers=H).json()
for k in kw["data"]["keywords"]:
    if not k["submitted"]:
        requests.post(BASE, params={"action":"challenge.submit"}, headers=H,
            json={"keyword_id":k["keyword_id"], "url":"https://blog.example.com/post"})
print(requests.get(BASE, params={"action":"challenge.status"}, headers=H).json())

자주 묻는 질문

Q. 챌린지 API가 403을 반환해요.
플래티넘 이상 플랜의 API 키인지 확인하세요. 프리미엄 이하는 키워드 검색 API만 사용할 수 있습니다.

Q. 호출 한도는?
플래티넘 120회/분, 엔터프라이즈 300회/분입니다. 초과 시 429 와 함께 retry_after 가 안내됩니다.

Q. 전체 엔드포인트 명세는 어디서 보나요?
👉 API 문서(레퍼런스) 에서 모든 파라미터와 응답 형식을 확인할 수 있습니다.