먼저 알아 둘 것
- 개발자센터의 '네이버 로그인'·'네이버 전자문서'·'네이버 인증서' 키는 쓸 수 없습니다. 이름이 같은 Client ID·Client Secret 이 나오지만 다른 API 용이라 연결 확인에서 '맞지 않는다'고 나옵니다. 서비스 URL·Callback URL 도 넣을 필요가 없습니다.
- 네이버 로그인 아이디·비밀번호나, 네이버클라우드 마이페이지 '인증키 관리'의 Access Key(ncp_iam_…)도 아닙니다. 아래 순서의 Application 에서 나오는 키를 씁니다.
- 2026년 7월 31일 전에 개발자센터에서 이미 받아 둔 검색 API 키는 2027년 6월 30일까지 그대로 쓸 수 있습니다.
- NAVER API HUB 는 지금 한시적으로 무료입니다 (유료로 바뀌면 네이버클라우드가 미리 알린다고 공지했습니다). 검색 API 는 한 달 775,000회, 검색어 트렌드는 한 달 50,000회까지 부를 수 있습니다.
1단계 — 네이버클라우드 가입·로그인
[console.ncloud.com](https://console.ncloud.com) 에 들어가 로그인합니다. 네이버 아이디로 가입할 수 있습니다. 처음이면 가입 절차에서 본인 확인 등을 거칩니다.
네이버클라우드는 다른 서비스를 쓰려면 결제 수단 등록을 요구할 수 있습니다. NAVER API HUB 는 지금 무료라 요금은 나가지 않습니다.
2단계 — NAVER API HUB 이용 신청
- 콘솔 왼쪽 위 [Menu] 를 누릅니다.
- Services → Application Services → NAVER API HUB 로 들어갑니다. (메뉴가 안 보이면 오른쪽 위 [리전 & 플랫폼]에서 한국 리전을 고른 뒤 [적용])
- 왼쪽의 [Subscription] 을 누르고 [서비스 이용 신청] 을 누릅니다.
- 약관 창에서 동의에 체크하고 [확인] 을 누릅니다.
3단계 — Application 등록 (키 만들기)
- 왼쪽의 [Application] → [Application 등록] 을 누릅니다.
- API 선택 화면에서 전부 체크합니다. 훈이애드 올인원은 블로그·카페·웹문서·뉴스·지역·검색어 트렌드를 씁니다. 하나만 빠져도 그 기능에서 '권한이 없다'고 나오니 다 고르는 게 편합니다. → [다음]
- Application 이름 을 적습니다. 영문·숫자·하이픈(-)만, 20자까지 됩니다. 한글은 안 됩니다. 예: hooniad
- [완료] 를 누릅니다.
등록한 뒤에 API 를 더 고르려면 Application 목록에서 그 줄의 메뉴(≡) → [Application 수정] 으로 들어갑니다.
4단계 — Client ID · Client Secret 복사
Application 목록에서 방금 만든 줄의 [인증 정보] 를 누르면 Client ID 와 Client Secret 이 나옵니다. 두 값을 각각 복사합니다. 남에게 보여 주지 마세요 — 새어 나갔다면 같은 화면의 [재발급] 으로 바꿀 수 있습니다.
5단계 — 훈이애드 올인원에 넣기
| 기능 | 넣는 곳 |
|---|---|
| 검색 순위 기록 | [보고서·설정] → 네이버 Client ID · Client Secret → [연결 확인] |
| 키워드 분석 | [설정] → 네이버 검색 API → Client ID · Client Secret → [연결 확인] |
| 한 번에 넣기 | 설정 → AI·연결 열쇠 → '네이버 검색 API Client ID / Secret' |
[연결 확인] 에 '네이버 검색 API 연결됐어요 (API HUB)' 가 나오면 끝입니다.
훈이애드 올인원 1.1.0 이상에서 API HUB 키가 됩니다. 1.0.0 은 예전 개발자센터 키만 받으니, 프로그램을 켜서 업데이트 알림이 오면 먼저 업데이트해 주세요.
'맞지 않는다'고 나올 때
| 나오는 말 | 원인 | 해결 |
|---|---|---|
| 키가 맞지 않아요 | 개발자센터의 다른 API(네이버 로그인·전자문서) 키, 로그인 비밀번호, Access Key 를 넣음 | 위 순서대로 NAVER API HUB Application 의 [인증 정보] 키를 넣기 |
| 권한이 없어요 | Application 을 만들 때 그 API 를 체크하지 않음 | [Application 수정] 에서 API 를 전부 체크 |
| 한도를 다 썼어요 | 그날·그달 호출 수를 넘김 | 다음 날 다시, 또는 확인할 키워드 수 줄이기 |
| 복사한 값 앞뒤에 빈칸 | 붙여넣을 때 딸려 옴 | 1.1.0 은 알아서 지웁니다 |
자주 묻는 질문
개발자센터에서 '검색' API 가 왜 안 보이나요?
네이버가 2026년 7월 31일부터 검색·데이터랩(검색어트렌드)·쇼핑인사이트 API 의 새 신청을 개발자센터에서 받지 않고 네이버클라우드 NAVER API HUB 로 옮겼기 때문입니다.
네이버 로그인 API 의 서비스 URL·Callback URL 은 뭘 넣나요?
검색 API 키에는 필요 없습니다. 네이버 로그인 API 는 다른 용도라 이 키로는 검색 기능을 쓸 수 없습니다. NAVER API HUB 에서 Application 을 만들어 주세요.
돈이 나가나요?
NAVER API HUB 는 지금 한시적으로 무료입니다. 유료로 바뀌면 네이버클라우드가 미리 알린다고 공지했습니다.
예전에 받은 개발자센터 키는요?
2026년 7월 31일 전에 받은 검색 API 키는 2027년 6월 30일까지 그대로 됩니다. 훈이애드 올인원 1.1.0 은 두 키를 알아서 구분해 보냅니다.
쇼핑 검색 순위는 왜 안 되나요?
네이버가 2026년 7월 31일에 쇼핑 검색 API 를 종료했습니다. 지난 기록만 볼 수 있습니다.
함께 보면 좋은 가이드
지금 광고 계정 상태부터 무료로 봐 드립니다.
무료 진단 신청하기 →