← 설정으로 돌아가기

🔑 네이버 API 키 발급 가이드

RankFinder는 본인의 네이버 API 키로 안전하게 운영됩니다. 약 10~15분 소요.

🔍
① 검색광고 API
키워드 검색량 조회용
🛒
② 쇼핑 검색 API
상품 순위·카테고리 분석용
🔍

① 검색광고 API 키 발급

⏱ 소요 시간: 약 5~7분 · 📋 필요한 것: 사업자등록증 (개인사업자 OK) · 💰 비용: 무료
  1. 1
    광고관리 시스템 가입

    👉 manage.searchad.naver.com 접속

    • 네이버 계정으로 로그인
    • "광고주 가입" 클릭
    • 사업자번호 입력 + 사업자등록증 이미지 업로드
    • 승인 대기 (보통 1~2시간, 평일 영업시간 내)
    💡 사업자 없으면? 개인사업자 등록 (1577-2266 무료 안내) 또는 가족·지인 사업자 명의로 가입 가능. 발급된 키는 본인 외 누구도 접근 못 함.
  2. 2
    API 사용 신청

    로그인 후 우측 상단

    도구 → API 사용 관리 → "네이버 검색광고 API 서비스 이용 신청" 클릭
    • 약관 동의 → 신청 완료 (즉시 활성화)
  3. 3
    라이선스 발급

    같은 페이지에서 "라이선스 발급" 버튼 클릭 → 3개 값이 표시됨:

    ①
    customerId
    광고주 ID — 7자리 숫자 (예: 1234567)
    ②
    엑세스라이선스 (accessKey)
    긴 hex 문자열 (74자) — 01000000... 로 시작
    ③
    비밀키 (secretKey)
    base64 문자열 (52자) — AQAAA... 로 시작, 끝의 == 포함
    ⚠ 비밀키는 발급 즉시 한 번만 표시됩니다.
    창을 닫기 전에 3개 모두 메모장에 복사해두세요.
    💡 키 잃어버려도 괜찮음: 같은 화면에서 "재발급" 누르면 새 키 생성됨 (기존 키 무효화).
  4. 4
    RankFinder 설정 페이지에 입력

    👉 설정 페이지 열기

    • "파워링크 (검색광고 API)" 섹션에 3개 값 붙여넣기
    • "💾 저장 + 🔍 검증" 버튼 클릭
    • 7초 대기 → ✓ 저장 + 검증 성공 표시 확인
🛒

② 쇼핑 검색 API 키 발급

⏱ 소요 시간: 약 3~5분 · 📋 필요한 것: 개인 네이버 계정만 · 사업자 불필요 · 💰 비용: 무료
  1. 1
    네이버 개발자센터 접속

    👉 developers.naver.com 접속

    • 본인 네이버 계정으로 로그인
    • 약관 동의 (처음 가입 시)
  2. 2
    애플리케이션 등록

    상단 메뉴

    Application → 애플리케이션 등록

    입력값:

    애플리케이션 이름
    RankFinder (자유 — 본인이 알아볼 이름)
    사용 API
    ✓ 검색 만 체크
    비로그인 오픈 API 환경
    WEB 설정 선택 → https://rankfinder.co.kr 입력
    • 약관 동의 → 등록 클릭
  3. 3
    Client ID / Secret 복사

    등록 직후 자동으로 발급되는 2개 값:

    ①
    Client ID
    영문 문자열 (약 20자) — 자동 생성됨
    ②
    Client Secret
    영문 문자열 (약 10자) — 자동 생성됨
    💡 이 두 값은 언제든 같은 페이지에서 다시 확인 가능 (검색광고 키와 다르게 일회성 아님).
  4. 4
    RankFinder 설정 페이지에 입력

    👉 설정 페이지 열기

    • "쇼핑 검색 API" 섹션에 2개 값 붙여넣기
    • "💾 저장 + 🛒 검증" 버튼 클릭
    • 7초 대기 → ✓ 저장 + 검증 성공 표시 확인

🆘 자주 묻는 질문 (FAQ)

Q1. 비용이 들나요?

아니요. 네이버 API는 무료입니다. 검색광고 API는 무료 한도가 매우 큽니다 (1일 1만 호출 이상). 쇼핑 API는 일 25,000회.

Q2. 두 API 같은 네이버 계정이어야 하나요?

아니요. 검색광고 API(광고주 계정)와 쇼핑 API(개발자 계정)는 완전히 독립적이라 다른 네이버 아이디로 발급받아도 작동 무관.

Q3. 안전한가요?

네. 입력한 키는 본인 워크스페이스에만 저장되며 Supabase Row-Level Security로 격리됩니다. 운영자(도야교수)도 직접 열람할 수 없습니다.

Q4. 검색광고 사업자등록증이 없어요

① 개인사업자 등록 (10분, 무료)
② 또는 가족·지인 사업자 명의로 가입
③ 베타 기간 한정 — 운영자 키 제공 옵션 (도야교수에게 문의)

Q5. 검증 실패하면?

① 키 복사 시 공백/줄바꿈 포함 확인
② 검색광고 secretKey 끝의 == 포함 확인
③ 라이선스 재발급 후 다시 시도
④ 그래도 안 되면 도야교수에게 화면 캡처 전달

Q6. 한도 초과되면?

본인 네이버 API 호출 한도가 일일 25,000회로 매우 큽니다. 일반 사용에선 거의 도달 안 함. 초과 시 다음날 자동 리셋.

🔍 검색광고 신청 바로가기 🛒 쇼핑 API 신청 바로가기 ⚙ 설정에서 키 등록 →

v1.1.0 BETA · 도야마케팅