NAVER API HUB 개요

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

NAVER API HUB는 네이버 블로그·이미지·웹·뉴스·백과사전·카페·지식iN 검색과 같은 다양한 검색 기능, 그리고 쇼핑 인사이트 및 검색어 트렌드를 조회할 수 있는 Data Lab 등 네이버의 데이터를 개발자가 손쉽게 활용할 수 있도록 API 형태로 제공합니다.

NAVER API HUB는 발급 키 하나로 여러 네이버 API를 연동하고, 사용한 만큼만 비용을 지불하는 종량제 방식으로 운영됩니다. 여러 API의 사용량·권한·비용은 하나의 콘솔에서 통합 관리할 수 있기 때문에 초기 연동부터 대규모 운영까지 유연하게 확장할 수 있습니다.

NAVER API HUB에서 제공하는 API

NAVER API HUB는 NAVER 검색과 Data Lab 카테고리에서 API를 제공합니다. 각 카테고리의 특징은 다음과 같습니다.

NAVER API HUB가 제공하는 다양한 기능

NAVER API HUB의 다양한 기능은 다음과 같습니다.

• 하나의 키로 다양한 네이버 API 연동: 검색, 쇼핑, 트렌드 등 다양한 네이버 API를 발급 키 하나로 연동할 수 있습니다. 별도의 개별 신청 없이 필요한 API를 선택해 바로 사용하고, 새로 추가되는 API도 즉시 이용할 수 있습니다.
• 통합 운영 관리와 비용 통제: 여러 API의 사용량·권한·비용을 하나의 콘솔에서 통합 관리할 수 있습니다. 호출량 모니터링과 임계치 설정으로 예산 리스크를 줄이고 안정적인 운영을 지원합니다.
• 종량제 기반의 유연한 사용: 사용한 만큼만 비용을 지불하는 종량제 방식으로, 서비스 규모에 맞춰 사용량을 자유롭게 조절할 수 있습니다. 초기 연동부터 대규모 운영까지 유연하게 확장할 수 있습니다.
  참고

  NAVER API HUB 서비스는 한시적으로 무료로 제공되며, 유료 전환 시 사전에 별도 공지로 안내될 예정입니다.

NAVER API HUB 사용 가이드 안내

NAVER API HUB는 한국 리전에서 서비스를 제공하고 있습니다. NAVER API HUB의 원활한 이용을 위해 다음 목차와 목차별 내용을 확인해 주십시오.

• NAVER API HUB 개요: NAVER API HUB 소개 및 제공 기능, 사용 가이드 안내, 연관 리소스 안내
• NAVER API HUB 사용 준비: NAVER API HUB 사용을 위한 클라우드 환경 사양 및 이용 요금 안내
• NAVER API HUB 이관 가이드: 기존 NAVER Developers Center에서 제공하던 API를 NAVER API HUB로 이관하여 사용할 때 확인해야하는 항목 안내
• NAVER API HUB 시나리오: 이용 신청, Application 등록, 인증정보 확인, API 이용, 이용량 조회까지 전체 프로세스 안내
• NAVER API HUB 시작: 네이버 클라우드 플랫폼 콘솔에서 NAVER API HUB 이용 방법 안내
  • Application: 서비스 이용 신청, Application 등록·수정·삭제, 이용 관리(이용량 확인, 이용 한도 설정, 임계치 알림 설정, 통보 대상 설정), 이용 해지 방법 안내
  • Usage Statistics: API 호출량 확인 방법 안내
• NAVER API HUB 사용: NAVER API HUB 서비스의 API 가이드 안내
• NAVER API HUB 상표 및 BI 사용: API를 이용해 개발한 서비스에 네이버 상표나 로고(BI)를 표시하는 경우 가이드라인 안내
• NAVER API HUB 리소스 관리: NAVER API HUB 리소스 관리 방법 안내
• NAVER API HUB 권한 관리: Sub Account를 활용한 NAVER API HUB 권한 관리 방법 안내
• NAVER API HUB 릴리스 노트: NAVER API HUB 사용 가이드 업데이트 이력

NAVER API HUB 연관 리소스

NAVER API HUB는 고객의 이해를 돕기 위해 사용 가이드 외에도 다양한 연관 리소스를 제공하고 있습니다. NAVER API HUB를 도입하기 위해 고민 중이거나 관련 정책을 수립하면서 자세한 정보가 필요한 개발자, 마케터 등은 다음 리소스를 적극 활용해 보십시오.

• NAVER API HUB에 대한 이해와 사용 방법 고도화
  • NAVER API HUB API 가이드: NAVER API HUB 개발자를 위한 API 사용 방법
  • 요금 소개, 특징, 상세 기능: NAVER API HUB의 요금 체계, NAVER API HUB의 특징 및 상세 기능 요약
  • 서비스 최신 소식: NAVER API HUB 관련 최신 소식
  • 자주 하는 질문: NAVER API HUB 사용자들이 자주 하는 질문
  • 문의하기: 사용 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의
• NAVER API HUB 이용에 필요한 연동 서비스 사용 가이드
  • Sub Account 사용 가이드: NAVER API HUB 권한 관리를 도와주는 Sub Account 사용 방법
  • Notification Recipient 사용 가이드: 이용량 임계치 초과 시 통보 대상 담당자 추가 등록 방법

자주 하는 질문을 먼저 확인해 보십시오.

사용 가이드를 읽기 전 자주 하는 질문에 대한 답변으로 궁금증을 빠르게 해소할 수 있습니다. 만약 다음의 자주 하는 질문에서 원하는 답을 얻지 못한 경우 사용 가이드에서 원하는 내용을 찾아서 확인해 보십시오.

호출 한도

Q. NAVER 검색 API의 호출 한도는 어떻게 되나요?
A. NAVER 검색 카테고리 내 API 호출 한도는 통합 관리되며 월 최대 775,000건까지 호출할 수 있습니다. 호출 한도는 일 단위가 아닌 월 단위로 관리됩니다.

Q. Data Lab(검색어 트렌드·쇼핑 인사이트)의 호출 한도는 어떻게 되나요?
A. 검색어 트렌드와 쇼핑 인사이트는 각각 월 최대 50,000건까지 호출할 수 있습니다. 이용 전 예상 사용량을 미리 확인해 두시기를 권장합니다.

Q. Rate Limit(초당 최대 요청 수)은 어떻게 되나요?
A. API Key당 최대 50 RPS가 적용됩니다. API 종류별 플랫폼 전체 한도는 NAVER 검색 1,000 RPS, Data Lab(검색어 트렌드·쇼핑 인사이트) 500 RPS입니다. 한도를 초과하면 429 Too Many Requests가 반환됩니다. 초당 RPS가 넘어서면 429가 리턴되며, 한계 RPS 아래로 내려와 1초가 지나면 다시 정상적으로 통신됩니다.

Q. 월 호출 한도를 모두 사용하면 어떻게 되나요?
A. 월 한도에 도달하면 호출이 자동으로 차단됩니다. 차단 전 사용량이 50%, 80%, 100%에 도달할 때마다 이메일 알림이 발송됩니다.

Q. 호출 한도를 늘릴 수 있나요?
A. 한시적 무료 제공 기간에는 호출 한도를 늘릴 수 없습니다.

Q. 여러 서비스에서 같은 API 키를 공유하면 호출 한도가 합산되나요?
A. 네, 동일한 API 키를 기준으로 호출량이 합산됩니다.

Data Lab (검색어 트렌드·쇼핑 인사이트)

Q. 검색어 트렌드와 쇼핑 인사이트는 별도로 신청하거나 키를 따로 발급받아야 하나요?
A. 하나의 Application에서 두 API를 함께 선택할 수 있으며, 하나의 API 키로 두 API를 모두 호출할 수 있습니다. 다만 두 API는 엔드포인트와 요청 파라미터가 다르므로 호출 코드는 각각 작성해야 하며, 월 호출 한도(각 50,000건)도 API별로 별도 산정됩니다.

Q. 검색어 트렌드 조회 시 한 번에 비교할 수 있는 키워드 수는 어떻게 되나요?
A. 한 번 요청에 최대 5개 그룹, 그룹당 최대 5개 키워드까지 조회할 수 있습니다.

Q. Data Lab에서 조회 가능한 데이터 기간은 어떻게 되나요?
A. 2016년 1월 1일 이후의 데이터를 조회할 수 있습니다.