Keyword Cockpit V2 개발이 80%를 넘긴 시점에 네이버 API가 다르게 동작하기 시작했다. 키워드로 조회한 상위 포스팅 목록에서 네이버 블로그 글이 하나도 나오지 않았고, 노출 레이더는 8월 26일 이후 모든 값이 같게 찍혔다.
검색 화면에서는 해당 글들이 여전히 상위에 노출되고 있었다. 도구가 읽어오는 값과 실제 검색 결과가 어긋난 것이다. 이 글은 원인을 찾아 네이버 API를 개발자 센터 방식에서 API HUB로 교체하기까지를 담았다. 가입 절차와 두 방식의 차이, 그리고 아직 해결하지 못한 부분까지 다루어 봤다.
키워드 검색량 조회 중 발견한 네이버 API 변화
기존 네이버 API로 괜찮을까?
지금까지 Keyword Cockpit V1.7에서는 네이버 개발자 센터에서 제공하는 Open API(검색 API)를 사용했다. 주력 기능으로는 키워드 검색량 조회, 블로그 지수, 노출 레이더를 제공한다. 그리고 이제 2달을 막 넘긴 시점에 네이버 AI 인용에도 노출이 되는 키워드 검색량 조회 도구로 자리 잡았다.
그러나 최근 V2 개발 과정에서 뜻밖의 이상징후를 포착하게 됐다. 검색 키워드로 조회되는 네이버 상위 포스팅 10개 목록이 아무래도 이상해 보였기 때문이다. 심지어 노출 레이더에서는 좀 더 심한 상황이 나왔다. 설정한 블로그의 최신 15개 글의 RSS를 읽어 키워드 노출 빈도와 순위 계산한 값을 지수로 보여줬는데, 이게 2026년 8월 26일 이후부터 죄다 동일한 값이 나오고 있었다.
작년 말 블로그 지수 조회 서비스들이 문을 닫은 것도 네이버의 보안 강화로 데이터를 가져오지 못하게 된 탓이었다. 그때는 남의 일이었는데 이번엔 내 도구에서 같은 일이 벌어졌다. 사실 이 글들이 네이버 검색에서 노출이 되고 있지 않다고 볼 수도 있겠지만, 막상 네이버에 검색을 해보면 그렇지 않다는 것을 알 수 있다. 3주 전 작성한 글이라 현재는 1등에서 밀린 것도 맞지만, 여전히 상위권에 노출되고 있다. 그러자 당연한 의문이 생기기 시작했다. 네이버 API 이대로 괜찮은걸까?
새로운 네이버 API HUB
얼마전 네이버 클라우드 폴랫폼(NAVER Cloud Platform)에 관한 안내를 받은 기억이 나서, 다시 메일을 찾아 봤다. 그리고 당시에는 그냥 넘겼던 기억도 떠올랐다. 기존 네이버 개발자 센터에서 제공되던 블로그 검색 API가 NAVER API HUB로 이관된다는 사실이었다. 혹시 이게 문제가 되는 것일까 싶었지만, 안내에는 분명 2027년 6월 30일까지 기존 인증키를 통한 호출 및 동작이 유효하다고 했다. 물론 쇼핑, 책, 전문자료 검색 API는 2026년 7월 31일 종료가 됐지만, Keyword Cockpit에서는 이들 API는 사용하지 않고 있다.
그렇다면 일단 새로운 네이버 API를 가지고 확인해 보는 게 가장 빠를 것 같았다. 결과가 상이하다면 최우선적으로 V2에 적용해야 할 것 같았기 때문이다. 새 버전을 내놓자마자 패치를 해야 하는 일은 없어야 하니까.
비교해 보자면
그렇다면 이 두 방식은 어떤 차이점이 있는 것일까? 정리를 해보기로 했다. 내게는 일단 새로운 인증 Key 하나로 전체 API를 컨트롤 할 수 있다는 점이 편리해 보였다. Vercel에서 변수로 일일이 넣어 관리하는 것도 일이라면 일이었으니까. 그리고 트래픽 부하가 걸리기 전 알림과 자동 차단 설정이 가능해진 점도 눈에 띄었는데, 추후에 이런 기능을 써볼 일이 생기려나? 아직은 하루 200명도 접속을 안하는 게 Keyword Cockpit의 현실이다.
| 구분 | 기존 NAVER 개발자 센터 (Legacy) | 신규 NAVER API HUB (NCP 기반) |
|---|---|---|
| 운영 주체 및 관리 | 네이버 개발자 센터 (독립 포털) | 네이버 클라우드 플랫폼 (NCP 콘솔) |
| 인증 방식 및 Key | API별 발급 | 단일 앱 통합 관리 |
| 인프라 구조 | 레거시 웹 서버 호출 방식 | API Gateway 기반 (엔드포인트, 상태코드 변경) |
| 쿼터 및 과금 체계 | 일간 제한 (예: 검색 1일 25,000건) | 월간 통합 제한 (예: 검색/데이터랩 월 775,000건) |
| 트래픽 및 비용 제어 | 트래픽 모니터링 기능 미흡 | 콘솔 내 트래픽 알림 및 자동 차단 한도 설정 제공 |
Keyword Cockpit V2 개발 중 네이버 API 변경 결정
키워드 검색량 조회 도구 개발 현황
여기에서 일단 궁금해하실 분도 있을테니, V2 소식을 살짝 전해보도록 하겠다. 현재 약 80% 수준의 개발을 마쳤으나, 이번 변화로 무용지물이 될 수 있는 기능을 처리해야 한다. 그러다 나중에 또 복귀가 되면 써야 할테니 단순 삭제는 피하기로 했다. 그러니 일이 더 많아지게 됐는데, 마킹해가며 확인하는 일이 은근히 신경 많이 쓰인다.
그런데 최근 희소식도 있다. 구글 Ads API Basic Access 권한을 부여 받은 일로, 이제 V2는 네이버 전용이란 딱지를 떼게 된 것이다. 구글 포스팅을 하는 사용자들도 이 도구를 활용할 수 있게 된다는 의미다.
네이버 API HUB 가입
네이버 API HUB에서 Key 발급을 받기 위해서는 네이버 클라우드 플랫폼에 회원가입부터 해야 한다. 그 다음 사용하고자 하는 어플리케이션 서비스로 네이버 API HUB 등록을 한다. 회원가입을 할 때는 이메일을 이용해야 하는데, 특이한 것은 결제 신용카드를 등록해야 최종 가입 완료 승인이 난다는 점이다. AWS나 GCP 등 글로벌 클라우드 서비스와 마찬가지인 셈인데, 네이버 API HUB 사용이 무료라고 해도 결제 정보 등록은 필수다.
그리고 지금 가입하면 2026년 11월 30일까지 한도가 걸려 있는 크레딧 200,000원을 제공 받는다. 이 정도면 크레딧이면 네이버 블로그 검색 외에도 AI나 지도(Map) 등 여러 API를 테스트 해보는데 충분할 것 같다. 충전 상태는 My Page/크레딧 관리 메뉴에서 가능하다.
네이버 API Key 발급
가입이 완료된 이후에는 사용하고자 하는 어플리케이션 이름을 생성하고, 여기서 사용할 API를 등록하는 절차를 거친다. 나는 Keyword Cockpit 으로 어플리케이션 생성 후, NAVER 검색과 Data Lab API를 추가했다. 그 다음 녹색 화살표가 가리키는 인증 정보를 클릭하면 새로 발급된 Key ID와 비밀번호를 확인할 수 있다.
이 과정은 생각보다 따라가기 수월했고, 오히려 여러 API 가운데 뭘 더 써봐야 할 지를 고민하게 했다. 네이버가 정말 많이 준비를 했구나 싶었다. 그러나 우선 Keyword Cockpit V2 개발을 마무리해야 하니, 네이버 API에 파고드는 건 잠시 미루고, 두 API 매뉴얼을 보기로 했다.
향후 네이버 API 변화 주목
새 방식을 확인하고 바로 테스트에 들어갔다. 기존 방식이라면 다음과 같은 코드를 사용했는데, 키워드 검색량 조회라는 키워드로 100개 포스팅을 읽기 위한 것이다. 이 결과에서는 앞서 언급한 이상징후가 보이게 되는데, 네이버 포스팅은 하나도 조회가 안되는 것이었다. 대신 대부분 티스토리 포스팅이 리턴되고 있었다.
/api/blog?query=키워드검색량조회&display=100&diag=1&api=legacy그다음으로는 서둘러서 네이버 API HUB를 통해 결과 값을 호출해보기로 했다. 이때 사용하는 코드 포맷은 다음과 같이 변경됐다. 구문 마지막에 붙던 api=legacy 대신 api=hub로 교체해주기만 하면 된다.
/api/blog?query=키워드검색량조회&display=100&diag=1&api=hub자주 묻는 질문
네이버 API를 통해 키워드 상위 포스팅 검색은 더 이상 불가능한가?
솔직히 이 부분은 저도 모르겠습니다. 하지만 네이버 블로그 글만 보이지 않는다는 점은 다시 복구되지 않을까 조심히 예상을 하며 꾸준히 모니터링 할 생각입니다.
NAVER API HUB 가입에 비용이 드나요?
가입 자체는 무료이고, 현재 일부 API 사용 유료 구간도 무료 제공 중입니다. 하지만 네이버 검색 API는 1일 25,000회, 월 775,000회 무료 제공중이라 헤비 유저가 많은 앱/웹 어플리케이션일 경우를 제외하면 충분해 보입니다.
Keyword Cockpit V2 출시일은 언제인가요?
현재 9월 1일 오픈을 목표로 준비중이나, 이번 동작 변화로 인해 화면 수정이 더 필요할 경우 조금 늦춰질 수도 있습니다. V2 오픈 전까지는 V1.7을 통해 네이버 키워드 검색량 조회는 동일하게 이용 가능합니다.
네이버 API를 LEGACY에서 HUB로 교체했지만 문제가 전부 풀린 것은 아니다. V1.7에서 가장 많이 쓰이던 기능인 본인 또는 특정 블로거의 포스팅 순위 확인과 노출 레이더는 두 방식 모두에서 제 역할을 못 하고 있다. 어느 쪽 문제인지도 아직 확정하지 못했다.
이번 일로 확인한 것은 외부 API에 기대는 도구는 내가 통제할 수 없는 변수를 안고 간다는 점이다. 공지에 적힌 종료일보다 실제 동작 변화가 먼저 올 수 있고, 그건 코드를 아무리 잘 짜도 막을 수 없다. 대신 할 수 있는 일은 값이 이상하면 바로 알아차릴 수 있게 해두는 것이다. 이번에도 노출 레이더의 값이 전부 같아진 것을 보고 눈치챘다.
구글 Ads API 승인으로 V2는 네이버 한쪽에만 기대지 않게 됐다. 9월 1일 오픈을 목표로 하고 있고, 순위 기능의 복구 여부는 계속 확인해 이 블로그에 남기겠다.
그 뒤 v2.0을 배포하면서 순위 기반 기능을 어떻게 처리했는지는 구글 키워드 검색을 붙인 기록에 구분해 남겼다.