FOR DEVELOPERS

내 사이트에서 키워드 데이터 활용

플래티넘·비즈니스 구독자는 API 키로 검색량과 입찰 참고가를 가져올 수 있습니다.

1. 구독 활성화

입금 확인 후 플래티넘 이상의 권한이 활성화됩니다.

2. 키 발급

내 계정에서 최대 3개의 키를 발급·폐기할 수 있습니다. 키 원문은 발급할 때 한 번만 보여줍니다.

3. 서버에서 호출

브라우저 코드에 키를 넣지 마세요. 웹과 API는 계정당 합산 100회/분입니다.

검색 요청 예시

curl --get 'https://www.theselfimprovementhomepage.com/kmfree-api' \
  -H 'X-API-Key: YOUR_API_KEY' \
  --data-urlencode 'action=search' \
  --data-urlencode 'keyword=키워드마스터'

기계가 읽는 API 가이드(JSON) · API 키 관리

상태	의미	처리
200	검색 성공	data와 fetched_at 확인
401 / 403	잘못된 키 / 구독 권한 없음	키와 구독 기간 확인
429	최근 60초 검색 한도 초과	Retry-After만큼 대기
404 / 503	자료 없음 / 일시 장애	검색어 확인 / 간격을 두고 재시도