NAVER API HUB 개요

Classic/VPC 환경에서 이용 가능합니다.

NAVER API HUB는 네이버의 검색 결과와 검색 데이터 분석 기능을 지원하는 네이버 클라우드 플랫폼의 서비스입니다. NAVER API HUB 서비스에서는 검색, 검색어 트렌드, 쇼핑 인사이트 기능에 대한 API를 RESTful 형태로 제공합니다.

API 키

NAVER API HUB는 권한을 가진 사용자만 호출할 수 있도록 식별 도구인 API 키를 계정별로 발급하고 있습니다. API 키는 API 호출 시 인증 정보로 전달하는 요청 헤더의 파라미터로 사용합니다. 따라서 NAVER API HUB를 사용하려면 우선 API 키를 발급받아야 합니다.

애플리케이션 등록

API 키는 네이버 클라우드 플랫폼 콘솔의 NAVER API HUB에서 발급할 수 있습니다. 애플리케이션을 등록하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
2. 콘솔 화면 우측 상단의 리전 & 플랫폼 버튼을 클릭해 주십시오.
3. 이용 중인 리전과 플랫폼을 선택한 후 [적용] 버튼을 클릭해 주십시오.
4. 콘솔 화면 좌측 상단의 Menu를 클릭해 주십시오.
5. All Services > Application Services > NAVER API HUB 메뉴를 차례대로 클릭해 주십시오.
6. 화면 좌측에서 Application 메뉴를 클릭해 주십시오.
7. Application Management 화면이 나타나면 [Application 등록] 버튼을 클릭해 주십시오.
8. 사용하고 싶은 API를 선택한 후 [다음] 버튼을 클릭해 주십시오.
9. Application 이름을 입력한 후 [완료] 버튼을 클릭해 주십시오.

API 키 발급

API 키는 네이버 클라우드 플랫폼 콘솔의 NAVER API HUB에서 발급할 수 있습니다. 발급 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
2. 콘솔 화면 우측 상단의 리전 & 플랫폼 버튼을 클릭해 주십시오.
3. 이용 중인 리전과 플랫폼을 선택한 후 [적용] 버튼을 클릭해 주십시오.
4. 콘솔 화면 좌측 상단의 Menu를 클릭해 주십시오.
5. All Services > Application Services > NAVER API HUB 메뉴를 차례대로 클릭해 주십시오.
6. 화면 좌측에서 Application 메뉴를 클릭해 주십시오.
7. Application Management 화면이 나타나면 Application을 선택한 다음 API 관리 하위에 [인증 정보] 버튼을 클릭해 주십시오.
8. 인증 정보 팝업 창이 나타나면 Client ID 와 Client Secret을 각각 복사한 다음 [확인] 버튼을 클릭해 주십시오.

Client Secret 재발급

Client Secret이 제3자에게 노출되었거나 도용이 의심되는 경우, 다시 발급해야 합니다. 재발급 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Menu > All Services > Application Services > NAVER API HUB 메뉴를 차례대로 클릭해 주십시오.
2. 화면 좌측에서 Application 메뉴를 클릭해 주십시오.
3. Application Management 화면이 나타나면 Application을 선택한 다음 API 관리 하위에 [인증 정보] 버튼을 클릭해 주십시오.
4. 인증 정보 팝업 창이 나타나면 [재발급] 버튼을 클릭해 주십시오.
5. Client Secret 변경 팝업 창이 나타나면 [확인] 버튼을 클릭해 주십시오.

NAVER API HUB 공통 설정

NAVER API HUB API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

https://naverapihub.apigw.ntruss.com

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

응답

공통 응답 형식을 설명합니다.

응답 바디

오류 응답 바디는 오류가 발생한 계층에 따라 다음 세 가지 형식 중 하나로 반환됩니다.

1. API Gateway 오류
인증 실패, 라우팅 실패 등 게이트웨이 계층에서 발생한 오류입니다. error 객체로 래핑되어 반환됩니다.

2. Search API 오류
Search API의 요청 파라미터 검증 오류입니다. 평면 구조로 반환됩니다.

3. Search Trend, Shopping Insight 오류
요청 바디 검증 오류입니다. 평면 구조로 반환됩니다.

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

응답 예시

호출이 성공한 경우의 응답 예시는 각 API 명세에서 확인해 주십시오. 호출이 실패한 경우의 응답 예시는 다음과 같습니다.

1. API Gateway 오류

{
    "error": {
        "errorCode": "200",
        "message": "Authentication Failed",
        "details": "Authentication information are missing."
    }
}

2. Search API 오류

{
    "errorCode": "SE02",
    "errorMessage": "Invalid display value (부적절한 display 값입니다.)"
}

3. Search Trend, Shopping Insight 오류

{
    "errMsg": "TypeError:  -> should have required property 'category'",
    "errId": "2026-06-11T17:51:49+09:00/804742176-19029958",
    "body": "{\"startDate\":\"2026-01-01\",\"endDate\":\"2026-03-31\",\"timeUnit\":\"month\"}"
}

NAVER API HUB API

NAVER API HUB 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

검색

검색 관련 API에 대한 설명은 다음과 같습니다.

검색어 트렌드

검색어 트렌드 관련 API에 대한 설명은 다음과 같습니다.

쇼핑 인사이트

쇼핑 인사이트 관련 API에 대한 설명은 다음과 같습니다.

NAVER API HUB 연관 리소스

NAVER API HUB API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.

• NAVER API HUB 서비스 사용 방법
  • NAVER API HUB 사용 가이드: 네이버 클라우드 플랫폼 콘솔에서 NAVER API HUB 사용하는 방법
  • Ncloud 사용 환경 가이드: VPC, Classic 환경 및 지원 여부에 관한 사용 가이드
  • 요금 소개, 특징, 상세 기능: NAVER API HUB의 요금 체계, NAVER API HUB의 특징, 상세 기능 및 활용 예시 요약
  • 서비스 최신 소식: NAVER API HUB 관련 최신 소식
  • 문의하기: API 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의