네이버 검색광고 API 발급
파워링크 자동화 도구나 키워드 분석 도구를 쓰려고 하면 꼭 “네이버 검색광고 API 키를 입력하세요”라는 단계가 나옵니다. 그런데 막상 검색광고 관리 화면에 들어가면 메뉴가 많아서 어디서 발급하는지 찾기 어렵죠. 이 글은 네이버 검색광고 API 발급 위치, 액세스 라이선스·비밀키·고객 ID가 각각 무엇인지, 외부 도구에 등록할 때 무엇을 조심해야 하는지 정리합니다.
- 발급 위치: 검색광고 관리 시스템 → 도구 → API 사용 관리(네이버 공식 안내 기준)
- 필요한 값은 세 가지: 액세스 라이선스, 비밀키, 고객 ID
- 비밀키는 요청 서명에 쓰이는 값이라 외부에 그대로 노출되면 안 됩니다.
- 유출이 의심되면 바로 재발급하고, 연결해 둔 도구에서도 삭제하세요.
API 키가 필요한 상황
네이버 검색광고는 관리 화면에서 직접 클릭으로 운영할 수도 있지만, 반복 작업이 많아지면 프로그램으로 처리하는 편이 정확합니다. 키워드 수백 개의 입찰가를 시간대마다 확인하거나, 연관 키워드 검색수를 한꺼번에 뽑거나, 여러 광고그룹의 상태를 한 표로 모아 보는 일이 대표적입니다. 이런 작업을 외부 도구가 대신하려면 내 광고 계정에 접근할 수 있는 열쇠가 필요한데, 그게 바로 API 키입니다.
- 자동입찰 도구: 목표 순위에 맞춰 입찰가를 주기적으로 조정
- 키워드 도구: 연관 키워드와 월간 검색수 조회
- 대량 관리: 키워드 일괄 등록, 켜기·끄기, 입찰가 일괄 변경
- 보고서: 캠페인·광고그룹 단위 성과 데이터 내려받기
반대로 관리 화면만 쓰는 경우라면 API 키를 만들 필요가 없습니다. 쓰지 않는 키를 만들어 두는 것 자체가 관리해야 할 위험이 하나 늘어나는 일이기 때문입니다.
발급 전 준비물 체크리스트
발급 자체는 오래 걸리지 않지만, 아래 항목이 갖춰져 있지 않으면 중간에 막힙니다. 특히 광고 계정 권한은 계정을 만든 사람과 실제로 운영하는 사람이 다를 때 자주 문제가 됩니다. 대행사나 지인이 만든 계정이라면 누가 API 키를 발급하고 보관할지 먼저 정해 두세요.
| 준비물 | 확인 방법 | 없을 때 |
|---|---|---|
| 네이버 검색광고 가입 | 네이버 검색광고 사이트에 로그인되는지 | 광고주 가입부터 진행 |
| 광고 관리 시스템 접근 | 관리 시스템 화면에 들어가지는지 | 계정 권한 확인 |
| API 발급 권한 | 도구 메뉴에 API 사용 관리가 보이는지 | 계정 소유자에게 요청 |
| 키를 보관할 곳 | 비밀번호 관리 도구 등 안전한 보관 장소 | 메신저·메모장 보관은 피하기 |
발급 단계
아래 순서는 네이버가 공식 API 샘플 저장소에 안내한 절차를 기준으로 정리했습니다(확인일 2026-10-06). 관리 화면의 메뉴 이름이나 위치는 개편으로 바뀔 수 있으니, 화면이 다르면 네이버 검색광고 공식 도움말을 함께 확인하세요.
- 검색광고 가입네이버 검색광고 사이트에서 광고주로 가입합니다.
- 관리 시스템 접속광고 관리 시스템에 로그인합니다.
- 도구 → API 사용 관리상단 도구 메뉴에서 API 사용 관리를 엽니다.
- 라이선스 생성API 라이선스를 만들면 액세스 라이선스와 비밀키가 나옵니다.
생성 직후에는 값을 바로 안전한 곳에 옮겨 두세요. 고객 ID는 같은 화면이나 계정 정보에서 확인할 수 있는 숫자 값입니다. 세 값을 모두 확보했다면 애드티온 설정 탭에 입력하면 되고, 저장 전에 실제 연결 확인을 거칩니다.
액세스 라이선스·비밀키·고객 ID의 역할 차이
세 값은 모두 API 요청에 쓰이지만 역할이 다릅니다. 네이버 검색광고 API는 요청마다 타임스탬프, 액세스 라이선스, 고객 ID를 헤더에 담고, 비밀키로 만든 서명을 함께 보내는 방식입니다(공식 샘플 코드 기준). 서명은 “타임스탬프.요청방식.경로” 문자열을 비밀키로 HMAC-SHA256 처리한 값이라, 비밀키가 없으면 유효한 요청을 만들 수 없습니다.
| 값 | 역할 | 노출 위험 |
|---|---|---|
| 액세스 라이선스 | 어떤 API 라이선스로 요청하는지 식별 | 단독으로는 요청 불가, 그래도 공개 금지 |
| 비밀키 | 요청 서명을 만드는 데 사용 | 가장 민감. 라이선스와 함께 유출되면 계정 조작 가능 |
| 고객 ID | 어느 광고 계정에 대한 요청인지 지정 | 식별 정보. 키와 함께라면 의미가 커짐 |
비밀키는 화면 캡처, 메신저 전송, 공유 문서 붙여넣기로 가장 많이 새어 나갑니다. 입력이 필요한 도구에만 직접 붙여 넣으세요.
키 유출 시 대처와 재발급
키가 유출되었다고 의심되는 순간이 있습니다. 공유 문서에 실수로 붙여 넣었거나, 퇴사한 직원이 키를 알고 있거나, 계정에 내가 하지 않은 변경 이력이 보일 때입니다. 이럴 때는 원인을 따지기 전에 키부터 바꾸는 것이 순서입니다. 키를 재발급하면 기존 키로는 더 이상 요청을 보낼 수 없게 되므로, 그 키를 쓰던 도구들도 새 키로 다시 연결해야 합니다.
- API 사용 관리 화면에서 기존 라이선스를 정리하고 새로 발급
- 연결해 둔 외부 도구에서 기존 키 삭제 후 새 키 등록
- 광고 관리 시스템의 변경 이력에서 의심되는 변경 확인
- 예산·입찰가 등 비용과 직결된 설정을 우선 점검
애드티온에서는 설정 탭의 “저장된 네이버 정보 삭제”를 누르면 키와 자동입찰 규칙이 함께 지워집니다. 새 키를 등록하면 연결 확인을 다시 거친 뒤에만 저장되므로, 잘못된 값이 남아 자동입찰이 엉뚱하게 도는 일은 생기지 않습니다.
자주 묻는 질문
API 키 발급에 비용이 드나요?
API 사용 조건과 정책은 네이버 검색광고가 정하며 바뀔 수 있습니다. 발급 전 API 사용 관리 화면과 공식 공지를 확인하세요.
여러 도구에 같은 키를 써도 되나요?
기술적으로는 가능하지만, 한 곳에서 유출되면 모든 도구를 다시 연결해야 합니다. 도구 수를 최소한으로 유지하는 편이 관리하기 쉽습니다.
대행사 계정의 키를 받아도 되나요?
계정 소유자의 동의 없이 키를 쓰는 것은 피해야 합니다. 누가 키를 발급하고 보관할지 계정 소유자와 먼저 합의하세요.
고객 ID를 잘못 넣으면 어떻게 되나요?
요청이 거절되어 연결 확인에 실패합니다. 애드티온은 연결 확인에 실패하면 값을 저장하지 않으므로 다시 확인 후 입력하면 됩니다.
본 콘텐츠는 일반적인 정보 제공을 목적으로 하며, 전문적인 조언(투자·의료·법률 등)을 대체하지 않습니다. 구체적인 판단은 반드시 해당 분야 전문가와 상담하시기 바랍니다.
본 내용은 의학적 진단·처방이 아니며, 정확한 진단과 치료는 반드시 의료기관 방문과 의료인 상담을 통해 받으시기 바랍니다. 치료 효과는 개인에 따라 다를 수 있습니다.
이 글은 AI(인공지능)의 도움을 받아 작성되었습니다.
