← 콘텐츠 가이드

2026-11-08 · 머니대외비

네이버 검색광고 API 키 발급과 등록 순서: CUSTOMER ID·ACCESS LICENSE·SECRET KEY

콘텐츠 가이드도구 사용법

키워드분석기의 총 검색량(PC·모바일)과 연관 키워드는 네이버 검색광고 API에서 가져옵니다. 이 API를 쓰려면 검색광고 계정에서 발급하는 값 세 가지가 필요합니다. 이 글은 발급 위치, 사이트에 넣는 위치, 넣은 뒤 오류가 날 때 확인할 순서를 정리합니다. 메뉴 이름은 2026년 11월 기준 네이버 검색광고 안내를 바탕으로 했으며, 네이버 화면이 바뀌면 이름이 달라질 수 있습니다.

1. 필요한 값 세 가지

사이트 입력 칸검색광고에서 부르는 이름역할
CUSTOMER ID광고계정 ID(CUSTOMER_ID)어느 광고 계정의 요청인지 알려 줍니다.
ACCESS LICENSE액세스라이선스API를 쓸 수 있는 계정인지 확인하는 키입니다.
SECRET KEY비밀키요청마다 서명을 만들어 위조를 막습니다. 다른 사람에게 보이면 안 됩니다.

세 값은 짝이 맞아야 합니다. 비밀키를 다시 발급했다면 예전 비밀키는 더 이상 쓰이지 않으므로, 사이트에 저장한 값도 새 값으로 바꿔야 합니다.

2. 검색광고에서 발급받기

  1. 네이버 검색광고(searchad.naver.com)에 네이버 아이디로 로그인합니다. 광고주 계정이 없다면 안내에 따라 계정을 먼저 만듭니다.
  2. 광고 시스템 상단 메뉴에서 도구 → API 사용 관리로 이동합니다.
  3. 네이버 검색광고 API 서비스 신청을 누르고 이용 약관을 확인한 뒤 동의합니다.
  4. 신청이 끝나면 화면에 CUSTOMER_ID, 액세스라이선스, 비밀키가 표시됩니다. 비밀키는 ‘보기’를 눌러야 전체가 보이는 경우가 있습니다.

값을 복사할 때 앞뒤 공백이 함께 복사되는 일이 잦습니다. 메모장에 한 번 붙여 넣고 공백이 없는지 확인한 뒤 옮기면 실수가 줄어듭니다. 키를 캡처해 카페나 단톡방에 올리지 마세요.

3. 머니대외비에 등록하기

  1. 상단 메뉴의 API/유료키설정에서 내 API 키 설정 열기를 누릅니다.
  2. ‘2. 네이버 검색광고 API’ 칸의 CUSTOMER ID, ACCESS LICENSE, SECRET KEY에 순서대로 붙여 넣습니다.
  3. 저장 및 적용하기를 누릅니다. 한 번 저장하면 키워드분석기, 애드센스&황금키워드, 홈판 키워드 등 다른 메뉴에도 함께 적용됩니다.
  4. 키워드분석기에서 단건 분석으로 아무 키워드나 하나 조회해 총 검색량이 나오는지 확인합니다.

저장한 키는 지금 쓰는 브라우저에만 저장됩니다. 다른 PC나 다른 브라우저에서는 다시 넣어야 하고, 브라우저의 사이트 데이터를 지우면 함께 지워집니다. 공용 PC에서는 사용 후 ‘초기화’로 지워 두세요.

4. 검색량이 안 나올 때 확인 순서

화면에 보이는 것먼저 확인할 것
인증 오류(401·403)세 값의 앞뒤 공백, CUSTOMER ID 자리에 다른 값을 넣지 않았는지, 비밀키를 재발급한 뒤 예전 값이 남아 있지 않은지
호출 제한(429)짧은 시간에 연속 조회했는지. 잠시 기다렸다가 다시 조회합니다. 실패한 키워드는 0이 아니라 ‘조회 실패’로 표시됩니다.
검색량은 나오는데 문서수만 실패검색광고 키가 아니라 블로그 검색 API 키 문제입니다. 블로그 검색·트렌드 API 키 안내를 확인하세요.
아주 작은 키워드가 10처럼 보임검색광고 API는 10 미만인 값을 ‘10 미만’으로만 알려 줍니다. 정확한 숫자로 쓰지 않습니다.

오류 화면별 자세한 순서는 API 오류 확인 순서에 정리했습니다.

5. 이 키로 할 수 있는 것과 없는 것

발행 전 확인

참고와 정정 안내

작성: 머니대외비(운영 임성화) · 확인일 2026년 11월 5일. 도구 화면과 수치는 이후 달라질 수 있습니다. 내용에 오류가 있거나 화면이 바뀌었다면 문의 페이지로 알려 주세요.

함께 읽기

다른 콘텐츠 가이드 읽기 →