네이버 검색 API 종료? 살아남는 API와 NAVER API HUB 이관 방법

네이버 검색 API가 종료됐다는 말은 절반만 맞습니다. 블로그·뉴스·카페글 같은 일반 검색, Search Trend, Shopping Insight는 NAVER API HUB로 이관됩니다. 반면 검색 API 가운데 쇼핑·책·전문자료는 2026년 7월 31일 완전히 종료됐고 공식 대체 API도 제공되지 않습니다.

한 줄 결론: 지금 할 일은 API를 버리는 것이 아니라, 사용 중인 기능을 ‘HUB 이관 대상’과 ‘완전 종료 대상’으로 먼저 나눈 뒤 새 계정·키·URL·인증 헤더로 옮기는 것입니다.

쉬운 비유로 보면 오래된 버스터미널이 문을 닫은 상황입니다. 뉴스·블로그·카페 검색 버스는 새 터미널로 옮겨 계속 운행하지만, 쇼핑·책·전문자료 노선은 새 터미널로 가지 않고 폐선됐습니다. “터미널이 바뀐다”와 “노선이 사라진다”를 구분해야 장애를 막을 수 있습니다.

목차

1. 무엇이 바뀌었나
2. 실제로 종료된 API와 마지막 응답값
3. HUB에서 새로 지원되는 API 전체 목록
4. 기존 응답과 HUB 응답을 옆으로 비교
5. 개발자·서비스 운영자들의 실제 반응
6. 기존 키는 언제까지 쓸 수 있나
7. NAVER API HUB 이관 5단계
8. URL과 인증 헤더 변경 예제
9. 호출 한도와 요금에서 달라지는 점
10. 종료 API 사용자는 어떻게 해야 하나
11. 배포 전 체크리스트
12. 공식 문서·반응 출처

1. 무엇이 바뀌었나

네이버는 개발자센터에서 제공하던 Search API, Search Trend, Shopping Insight를 네이버클라우드의 NAVER API HUB로 옮겼습니다. 새 신청자는 기존 Developers Center가 아니라 네이버클라우드 플랫폼 계정과 HUB 콘솔을 사용해야 합니다.

현재가 2026년 8월이라면 첫 번째 마감일은 이미 지났습니다. 새 프로젝트에서 예전 개발자센터 키를 신청하는 방식은 선택지가 아니며, 쇼핑·책·전문자료 검색 호출은 기존 사용자도 더 이상 정상 동작한다고 가정하면 안 됩니다.

2. 실제로 종료된 API와 마지막 응답값

공식 종료 공지가 지목한 서비스는 검색 쇼핑·책·전문자료 3종입니다. 실제 코드 수준에서는 책의 상세 검색까지 포함해 아래 엔드포인트를 찾아야 합니다. .json과 .xml은 같은 검색 기능의 반환 형식입니다.

중요: 아래 값은 종료 전 공식 레퍼런스에 실린 응답 예시를 읽기 쉽게 JSON 형태로 축약한 것입니다. 지금 라이브 호출로 새로 받은 값이 아닙니다.

쇼핑 검색이 돌려주던 값

{
  "title": "허니트립 보스턴백",
  "link": "상품 정보 URL",
  "image": ".../10315467179.jpg",
  "lprice": 6700,
  "hprice": 0,
  "mallName": "허니트립",
  "productId": 10315467179,
  "productType": 2,
  "maker": "허니트립",
  "category1": "패션잡화",
  "category2": "여행용가방/소품",
  "category3": "보스턴백"
}

책 검색이 돌려주던 값

{
  "title": "불곰의 <b>주식</b>투자 불패공식",
  "link": "네이버 도서 정보 URL",
  "image": ".../10834650.jpg",
  "author": "불곰 박선목",
  "discount": 14400,
  "publisher": "부키",
  "pubdate": "20160729",
  "isbn": "8960515523 9788960515529",
  "description": "잘못된 주식투자 습관을 ..."
}

전문자료 검색이 돌려주던 값

{
  "title": "차등의결권 <b>주식</b>의 도입에 관한 법적 연구",
  "link": "전문 문서 URL",
  "description": "제1장 서론 ... 제2장 차등의결권 주식 제도의 개관 ..."
}

종료된 세 API는 “새 주소로 이동”한 것이 아닙니다. 새 URL과 새 응답 자체가 없으므로 파서 수정이 아니라 데이터 공급 구조 재설계가 필요합니다.

가장 헷갈리는 부분: 쇼핑 검색과 Shopping Insight는 다르다

검색 쇼핑 API는 검색어에 맞는 상품 목록과 가격을 돌려주던 기능이고 종료됐습니다. 반면 Shopping Insight는 카테고리·키워드별 클릭 추이를 ratio로 반환하는 트렌드 API이며 HUB로 옮겨졌습니다. Shopping Insight만으로 상품명·가격·상품 URL을 복원할 수 없습니다.

3. HUB에서 새롭게 지원되는 API 전체 목록

NAVER API HUB의 검색 메뉴에 실제로 올라온 기능은 아래 10종입니다. 기존 JSON/XML 확장자는 사라지고, 새 경로에서 format=json|xml을 선택하는 방식으로 바뀌었습니다.

Search Trend도 이관됐다

Shopping Insight 8개 조회도 이관됐다

4. 기존 응답과 HUB 응답을 옆으로 비교

공식 문서의 예시를 대조하면 성공 응답은 상당 부분 유지됐습니다. 크게 바뀐 것은 계정, 도메인, 경로, 인증 헤더입니다. 다만 네이버 공식 이관 가이드도 “응답 Body 구조와 주요 필드는 API별 확인 필요”라고 명시하므로 실제 운영 파서를 무검증으로 재사용하면 안 됩니다.

뉴스: 값은 바뀌어도 필드 구조는 같다

{
  "lastBuildDate": "Mon, 26 Sep 2016 ...",
  "total": 2566589,
  "start": 1,
  "display": 10,
  "items": [{
    "title": "국내 <b>주식</b>형펀드서 ...",
    "originallink": "연합뉴스 원문 URL",
    "link": "네이버 또는 원문 URL",
    "description": "기사 요약 ...",
    "pubDate": "Mon, 26 Sep 2016 07:50:00 +0900"
  }]
}

{
  "lastBuildDate": "Thu, 11 Jun 2026 19:03:00 +0900",
  "total": 2388472,
  "start": 1,
  "display": 2,
  "items": [{
    "title": "네이버, '로컬 그라운드' 캠페인 추진 ...",
    "originallink": "기사 원문 URL",
    "link": "기사 URL",
    "description": "로컬 브랜드 <b>커피</b> ...",
    "pubDate": "Thu, 11 Jun 2026 18:34:00 +0900"
  }]
}

판정: items 안의 다섯 필드는 유지됩니다. 검색어 일치 부분의 <b> 태그 처리도 계속 필요합니다.

블로그: 기존 파서를 재사용할 가능성이 높지만 실호출 검증은 필수

{
  "title": "명예훼손 없이 <b>리뷰</b>쓰기",
  "link": "블로그 포스트 URL",
  "description": "포스트 요약 ...",
  "bloggername": "블로그 이름",
  "bloggerlink": "블로그 주소",
  "postdate": "20161208"
}

{
  "title": "<b>커피</b> 원두 고르는 법과 홈카페 입문 팁",
  "link": "https://blog.naver.com/{blogId}/{logNo}",
  "description": "오늘은 <b>커피</b> 원두를 ...",
  "bloggername": "{블로그 이름}",
  "bloggerlink": "blog.naver.com/{blogId}",
  "postdate": "20260611"
}

판정: 주요 여섯 필드가 그대로입니다. URL과 헤더를 바꾸고 같은 파서로 통과할 가능성이 높지만, 링크 형식과 빈 필드까지 샘플 질의로 대조해야 합니다.

나머지 검색 API의 응답도 이렇게 이어진다

Search Trend: 응답 배열은 유지되고 주소가 바뀐다

{
  "startDate": "2023-01-01",
  "endDate": "2023-06-30",
  "timeUnit": "month",
  "results": [{
    "title": "한글",
    "keywords": ["한글", "korean"],
    "data": [{"period":"2023-03-01","ratio":100}]
  }]
}

{
  "startDate": "2023-01-01",
  "endDate": "2023-06-30",
  "timeUnit": "month",
  "results": [{
    "title": "한글",
    "keywords": ["한글", "korean"],
    "data": [{"period":"2023-03-01","ratio":100}]
  }]
}

Shopping Insight: 상품 목록이 아니라 상대 클릭 추이만 유지된다

{
  "startDate": "2023-11-01",
  "endDate": "2023-11-07",
  "timeUnit": "date",
  "results": [{
    "title": "패션의류",
    "category": ["50000000"],
    "data": [{"period":"2023-11-01","ratio":76.30839}]
  }]
}

{
  "startDate": "2023-11-01",
  "endDate": "2023-11-07",
  "timeUnit": "date",
  "results": [{
    "title": "패션의류",
    "category": ["50000000"],
    "data": [{"period":"2023-11-01","ratio":76.30839}]
  }]
}

ratio는 실제 클릭 수가 아니라 조회 구간 최대값을 100으로 둔 상대값입니다. 종료된 쇼핑 검색의 lprice, productId, mallName을 대신하지 않습니다.

성공 응답보다 오류 응답이 더 크게 달라질 수 있다

{
  "errorCode": "SE02",
  "errorMessage": "Invalid display value"
}

{
  "error": {
    "errorCode": "...",
    "message": "...",
    "details": "..."
  }
}

기존 코드가 errorCode 하나만 읽는다면 HUB의 Gateway 오류를 놓칠 수 있습니다. HTTP 상태를 먼저 보고, 최상위 error 객체와 평면형 errorCode를 모두 처리해야 합니다.

5. 개발자·서비스 운영자들의 실제 반응

공개 반응은 아직 표본이 작아 개발자 전체 여론으로 일반화할 수 없습니다. 그러나 확인 가능한 사례는 공통적으로 기존 예제 실패, 갑작스러운 기능 장애, 대체 API 탐색, 수집 구조 재설계에 집중돼 있습니다.

“발급 부분만 바뀐 게 아니라 호출방식도 변경되어 Developers Center 엔드포인트·헤더가 아닌 API HUB 방식으로 프롬프트도 변경하셔야 할 듯합니다.”

실제로 해당 수강자는 “검색 목록이 뜨질 않는다”고 질문했고, 강의 제공자는 API 내용을 재확인해 업데이트하겠다고 답했습니다. 오래된 강의·블로그 예제를 그대로 복사하면 키 발급 단계뿐 아니라 실행 단계에서도 막힐 수 있다는 사례입니다.

“독서 기록 앱 하나가 책추가 검색하니 책이 하나도 안 보였어요. NAVER 개발자 센터가 네이버 API HUB로 바껴서 안 되는 경우도 있어요.”

“한국책 검색에 사용해오던 네이버 API가 서비스 종료를 했네요..! 따로 전달받은 곳이 없어서 부랴부랴 카카오 API로 전환해서 심사를 올려두었습니다.”

“7월 31일 오후 5시부터 책검색이 안되고 있었습니다. 이유는 네이버에서 책검색 API를 중단했기 때문입니다. 미리 알았다면 준비를 했었을 텐데...”

“네이버 책 검색 Open API가 종료하네. 네이버가 돈 안 되는 것은 없애나 보다. 책 관리 앱이나 서비스는 책 검색으로 뭘 써야 할까? 유료라도 좀 싸게 제공하면 좋을 텐데.”

“기존 API에 의존하던 기능을 다시 설계하고 있으며... 공식 API 종료 이후에는 같은 방식으로 데이터를 받을 수 없기 때문에 순위 조회와 분석 기능을 새로운 구조로 전환하고 있습니다.”

“OpenAPI에 의존하던 순위 수집 배치가 실패한다. 외부 SaaS·자체 봇의 쇼핑 순위 모듈이 비어 간다.”

셀로몬과 랭클리의 글은 독립적인 사용자 후기가 아니라 해당 서비스의 공식 대응·마케팅 자료입니다. 특히 ‘실검색’ 방식이 네이버 정책에 항상 적합하거나 장기적으로 안정적이라는 뜻은 아니므로, 대안 기술을 고를 때 약관·로봇 정책·차단 가능성을 별도로 검토해야 합니다.

6. 기존 키는 언제까지 쓸 수 있나

2026년 7월 30일 24시까지 이관 대상 API를 신청한 기존 사용자는 개발자센터 방식으로 2027년 6월 30일 24시까지 한시적으로 사용할 수 있습니다. 이 유예는 일반 Search API·Search Trend·Shopping Insight에 해당합니다.

그러나 쇼핑·책·전문자료 검색에는 이 유예가 적용되지 않습니다. 해당 API는 기존 키를 가진 사용자도 2026년 7월 31일 종료 대상입니다.

기존 키가 아직 작동한다고 이관을 미루면 안 됩니다. 인증·URL·한도·오류 처리를 한꺼번에 바꾸는 작업은 운영 트래픽을 받기 전에 병행 검증해야 합니다.

7. NAVER API HUB 이관 5단계

1단계: 사용 중인 API 목록 만들기

코드 저장소와 환경 변수에서 openapi.naver.com, X-Naver-Client-Id, X-Naver-Client-Secret을 검색합니다. 실제 호출 경로, 일평균·월간 호출량, 호출하는 화면과 배치 작업도 함께 기록합니다.

2단계: 네이버클라우드 플랫폼 계정과 Application 만들기

NAVER API HUB는 네이버클라우드 플랫폼 콘솔에서 사용합니다. Application을 생성하고 필요한 Search API, Search Trend 또는 Shopping Insight를 선택합니다.

3단계: 새 Client ID와 Client Secret 발급하기

기존 Developers Center 키를 그대로 옮겨 쓰는 방식이 아닙니다. HUB용 인증 정보를 새로 발급하고 서버의 시크릿 저장소나 환경 변수에 보관합니다. 브라우저 코드나 공개 저장소에 Secret을 넣지 않습니다.

4단계: 호출 도메인·경로·인증 헤더 바꾸기

기존 openapi.naver.com 호출을 naverapihub.apigw.ntruss.com 기반 주소로 변경합니다. 경로와 인증 헤더도 달라지므로 단순히 도메인만 교체해서는 안 됩니다.

5단계: 병행 테스트 후 트래픽 전환하기

같은 질의를 이전 방식과 HUB 방식으로 호출해 상태 코드, 응답 필드, 정렬, 페이징, 한글 인코딩을 확인합니다. 401·403·429와 타임아웃을 로그와 알림에 연결한 뒤 운영 트래픽을 단계적으로 옮깁니다.

8. URL과 인증 헤더 변경 예제

공식 이관 가이드의 뉴스 검색 예시를 비교하면 핵심 변경점이 분명합니다.

기존 개발자센터 방식

curl -G "https://openapi.naver.com/v1/search/news.json"   -H "X-Naver-Client-Id: OLD_CLIENT_ID"   -H "X-Naver-Client-Secret: OLD_CLIENT_SECRET"   --data-urlencode "query=와플보드"   --data "display=5"

NAVER API HUB 방식

curl -G "https://naverapihub.apigw.ntruss.com/search/v1/news"   -H "X-NCP-APIGW-API-KEY-ID: HUB_CLIENT_ID"   -H "X-NCP-APIGW-API-KEY: HUB_CLIENT_SECRET"   --data-urlencode "query=와플보드"   --data "display=5"

위 코드는 뉴스 검색 예시입니다. 블로그·카페글·트렌드 등 다른 기능은 각각의 HUB 개발 가이드에서 정확한 경로와 파라미터를 다시 확인해야 합니다. 모든 API가 뉴스 경로와 동일하다고 복사하면 안 됩니다.

9. 호출 한도와 요금에서 달라지는 점

공식 NAVER API HUB 개요는 현재 기준으로 다음 한도를 안내합니다.

문서 간 표현 차이: 개별 검색 API 페이지에는 아직 ‘하루 25,000회’라고 적혀 있지만 HUB 개요의 FAQ는 NAVER 검색 카테고리를 ‘월 최대 775,000건 통합 관리’라고 설명합니다. 실제 운영 한도는 HUB 콘솔의 Application 이용량과 최신 공지를 우선 확인해야 합니다.

• Search API 통합: 월 최대 775,000건
• Search Trend: 월 최대 50,000건
• Shopping Insight: 월 최대 50,000건
• API 키당 최대: 50 RPS
• 한도 초과 시 429 응답

서비스는 현재 한시적으로 무료이며 향후 유료 요금제 도입 시 별도 공지가 예정돼 있습니다. 확정되지 않은 초과 단가를 임의로 계산하거나 “2027년부터 무조건 유료”라고 단정하면 안 됩니다.

운영에서는 월 총량만 볼 것이 아니라 키를 공유하는 여러 서버·배치의 호출이 합산되는지 확인하고, 50%·80%·100% 구간 알림과 429 백오프를 준비하는 편이 안전합니다.

10. 종료 API 사용자는 어떻게 해야 하나

네이버는 세 종료 API에 대해 NAVER API HUB를 포함한 공식 대체 API를 제공하지 않는다고 안내했습니다. 따라서 주소만 바꾸는 ‘이관 작업’으로 해결할 수 없습니다.

1. 기능 의존성 확인: 검색 결과가 사라지면 깨지는 상품 목록, 가격 비교, 책 추천, 전문자료 화면을 찾습니다.
2. 데이터 계약 확인: 다른 제공자의 공식 API, 제휴 피드, 직접 보유한 데이터처럼 이용 조건이 분명한 대안을 검토합니다.
3. 무단 수집으로 급히 대체하지 않기: 공개 화면을 크롤링하면 된다고 단정하지 말고 이용약관·저작권·로봇 정책과 안정성을 확인합니다.
4. 기능 축소 대비: 대안을 확보하지 못하면 검색 기능을 숨기고 사용자에게 종료 사유를 안내합니다.
5. 캐시 실패 처리: 오래된 결과를 최신 데이터처럼 계속 보여주지 말고 수집 시점과 중단 상태를 표시합니다.

11. 배포 전 체크리스트

• 사용 중인 API를 HUB 이관 대상과 완전 종료 대상으로 분류했는가?
• 코드와 환경 변수에서 기존 도메인·헤더·키를 모두 찾았는가?
• NAVER API HUB Application에 필요한 API를 선택했는가?
• 새 Client ID와 Secret을 서버 시크릿으로 보관했는가?
• API별 최신 경로와 파라미터를 공식 가이드에서 확인했는가?
• 정상 응답뿐 아니라 401·403·429·타임아웃을 시험했는가?
• 월간 한도와 RPS를 모니터링하고 알림을 설정했는가?
• 쇼핑·책·전문자료 기능의 대체 또는 종료 화면을 준비했는가?
• 구 방식과 HUB 방식을 병행 비교한 뒤 전환했는가?
• 2027년 6월 30일보다 충분히 일찍 기존 키 제거 일정을 잡았는가?

이번 개편의 핵심은 “네이버 검색 API가 끝났다”가 아니라 “계속되는 API와 사라진 API의 길이 갈라졌다”입니다.

블로그·뉴스·카페글 검색이나 트렌드 분석을 사용한다면 HUB 전환 계획을 세우면 됩니다. 상품·책·전문자료 검색을 사용했다면 공식 대체 API가 없으므로 서비스 기능 자체를 다시 설계해야 합니다.

외부 검색 데이터와 자동화 기능을 사용하는 커뮤니티를 운영한다면 API 장애가 게시판과 콘텐츠 공급까지 번지기 전에 의존성을 정리해야 합니다. 와플보드의 커뮤니티 기능과 구축 비용을 확인하거나, 필요한 데이터 연동 구조를 상담해 보세요. 다른 API 자동화 사례는 쿠팡 파트너스 API 사용방법에서도 볼 수 있습니다.

12. 공식 문서·반응 출처

1. NAVER Developers, Search API·Search Trend·Shopping Insight 종료 및 NAVER API HUB 이관 안내
2. NAVER Developers, 검색 쇼핑·책·전문자료 API 종료 안내
3. NAVER Cloud Platform, NAVER API HUB 이관 가이드
4. NAVER Cloud Platform, NAVER API HUB 개요·호출 한도
5. 종료 전 쇼핑 검색 API 레퍼런스와 응답 예시
6. 종료 전 책·책 상세 검색 API 레퍼런스와 응답 예시
7. 종료 전 전문자료 검색 API 레퍼런스와 응답 예시
8. HUB 뉴스 검색 응답 예시
9. HUB 블로그 검색 응답 예시
10. HUB 백과사전 검색 응답 예시
11. HUB 검색어 트렌드 조회
12. HUB 쇼핑 인사이트 분야별 트렌드
13. 인프런, 네이버 API 이관 관련 질문과 답변
14. 퀄렉트 운영자의 책 검색 API 종료 대응
15. riida 운영자의 책 검색 장애 공지
16. 셀로몬, 쇼핑 API 종료 대응 공지
17. 랭클리, 쇼핑 API 종료 대안 가이드

이 글은 2026년 8월 8일 확인한 공식 공지와 가이드를 기준으로 작성했습니다. 호출 경로, 한도와 요금은 변경될 수 있으므로 실제 전환 직전에 최신 공식 문서를 다시 확인하세요.