키워드분석기의 총 검색량(PC·모바일)과 연관 키워드는 네이버 검색광고 API에서 가져옵니다. 이 API를 쓰려면 검색광고 계정에서 발급하는 값 세 가지가 필요합니다. 이 글은 발급 위치, 사이트에 넣는 위치, 넣은 뒤 오류가 날 때 확인할 순서를 정리합니다. 메뉴 이름은 2026년 11월 기준 네이버 검색광고 안내를 바탕으로 했으며, 네이버 화면이 바뀌면 이름이 달라질 수 있습니다.
1. 필요한 값 세 가지
| 사이트 입력 칸 | 검색광고에서 부르는 이름 | 역할 |
|---|---|---|
| CUSTOMER ID | 광고계정 ID(CUSTOMER_ID) | 어느 광고 계정의 요청인지 알려 줍니다. |
| ACCESS LICENSE | 액세스라이선스 | API를 쓸 수 있는 계정인지 확인하는 키입니다. |
| SECRET KEY | 비밀키 | 요청마다 서명을 만들어 위조를 막습니다. 다른 사람에게 보이면 안 됩니다. |
세 값은 짝이 맞아야 합니다. 비밀키를 다시 발급했다면 예전 비밀키는 더 이상 쓰이지 않으므로, 사이트에 저장한 값도 새 값으로 바꿔야 합니다.
2. 검색광고에서 발급받기
- 네이버 검색광고(searchad.naver.com)에 네이버 아이디로 로그인합니다. 광고주 계정이 없다면 안내에 따라 계정을 먼저 만듭니다.
- 광고 시스템 상단 메뉴에서 도구 → API 사용 관리로 이동합니다.
- 네이버 검색광고 API 서비스 신청을 누르고 이용 약관을 확인한 뒤 동의합니다.
- 신청이 끝나면 화면에 CUSTOMER_ID, 액세스라이선스, 비밀키가 표시됩니다. 비밀키는 ‘보기’를 눌러야 전체가 보이는 경우가 있습니다.
값을 복사할 때 앞뒤 공백이 함께 복사되는 일이 잦습니다. 메모장에 한 번 붙여 넣고 공백이 없는지 확인한 뒤 옮기면 실수가 줄어듭니다. 키를 캡처해 카페나 단톡방에 올리지 마세요.
3. 머니대외비에 등록하기
- 상단 메뉴의 API/유료키설정에서 내 API 키 설정 열기를 누릅니다.
- ‘2. 네이버 검색광고 API’ 칸의 CUSTOMER ID, ACCESS LICENSE, SECRET KEY에 순서대로 붙여 넣습니다.
- 저장 및 적용하기를 누릅니다. 한 번 저장하면 키워드분석기, 애드센스&황금키워드, 홈판 키워드 등 다른 메뉴에도 함께 적용됩니다.
- 키워드분석기에서 단건 분석으로 아무 키워드나 하나 조회해 총 검색량이 나오는지 확인합니다.
저장한 키는 지금 쓰는 브라우저에만 저장됩니다. 다른 PC나 다른 브라우저에서는 다시 넣어야 하고, 브라우저의 사이트 데이터를 지우면 함께 지워집니다. 공용 PC에서는 사용 후 ‘초기화’로 지워 두세요.
4. 검색량이 안 나올 때 확인 순서
| 화면에 보이는 것 | 먼저 확인할 것 |
|---|---|
| 인증 오류(401·403) | 세 값의 앞뒤 공백, CUSTOMER ID 자리에 다른 값을 넣지 않았는지, 비밀키를 재발급한 뒤 예전 값이 남아 있지 않은지 |
| 호출 제한(429) | 짧은 시간에 연속 조회했는지. 잠시 기다렸다가 다시 조회합니다. 실패한 키워드는 0이 아니라 ‘조회 실패’로 표시됩니다. |
| 검색량은 나오는데 문서수만 실패 | 검색광고 키가 아니라 블로그 검색 API 키 문제입니다. 블로그 검색·트렌드 API 키 안내를 확인하세요. |
| 아주 작은 키워드가 10처럼 보임 | 검색광고 API는 10 미만인 값을 ‘10 미만’으로만 알려 줍니다. 정확한 숫자로 쓰지 않습니다. |
오류 화면별 자세한 순서는 API 오류 확인 순서에 정리했습니다.
5. 이 키로 할 수 있는 것과 없는 것
- 할 수 있는 것: 월간 PC·모바일 검색수, 검색광고 기준 연관 키워드 목록, 경쟁 정도 표시.
- 할 수 없는 것: 블로그 문서수, 최근 30일 발행 글 수, 일별 검색 추이. 이 값들은 블로그 검색 API와 DataLab API가 필요합니다.
- 검색광고 API의 월간 검색수는 광고 집행을 위한 추정치입니다. 내 글의 예상 방문자 수로 바로 바꿔 읽지 마세요.
발행 전 확인
- 글에 키 값이나 키가 보이는 캡처를 넣지 않았는가?
- 검색량을 인용할 때 조회일을 함께 적었는가?
참고와 정정 안내
작성: 머니대외비(운영 임성화) · 확인일 2026년 11월 5일. 도구 화면과 수치는 이후 달라질 수 있습니다. 내용에 오류가 있거나 화면이 바뀌었다면 문의 페이지로 알려 주세요.