본문 바로가기
API

[네이버 Open API] 네이버 Search API를 통해 최신 뉴스 조회해보기 (Feat.Postman)

by Devyne 2025. 4. 5.
반응형
네이버 개발자 센터에서 제공하는 Search API를 통해 최신 뉴스 기사 타이틀을 가져오고자 한다. 이를 통해 기사 타이틀을 가져온 다음 OpenAI API를 활용해 해당 타이틀을 가지고 블로그 글을 작성해달라고 요청할 것이다. (앞으로의 계획) 우선 Postman을 통해 API 테스트를 해보자! 

1. 네이버 개발자센터에서 API 키 발급받기

네이버 Search API를 사용하려면 우선 네이버 개발자센터에서 클라이언트 아이디와 클라이언트 시크릿 키를 발급받아야 한다.

  • 접속 주소: 네이버 개발자센터
  • Application 메뉴에서 새 앱을 등록하고, API 사용신청을 하면 키가 발급하면 된다.

애플리케이션 등록 (사용 API : 검색)

 

API 사용신청 시 사용 API에서 검색 을 선택해주면 된다.

애플리케이션 등록 후 내 애플리케이션 에 들어가면 내가 만든 애플리케이션이 보일 것이다.

애플리케이션 정보에 다 보면 Client ID  Client Secret 정보가 보인다.

 

애플리케이션 정보

이따 API 요청 시 Headers에 정보를 기입해야한다. 


2. 네이버 뉴스 검색 API url 및 파라미터

네이버 뉴스 타이틀을 가져오는게 목표이기 때문에 검색 API 중 뉴스를 활용할 것이다.

자세한 문서는 아래 링크를 참고하면 된다.

https://developers.naver.com/docs/serviceapi/search/news/news.md#뉴스

 

검색 > 뉴스 - Search API

검색 > 뉴스 뉴스 검색 개요 개요 검색 API와 뉴스 검색 개요 검색 API는 네이버 검색 결과를 뉴스, 백과사전, 블로그, 쇼핑, 웹 문서, 전문정보, 지식iN, 책, 카페글 등 분야별로 볼 수 있는 API입니다

developers.naver.com

 

뉴스 검색 API의 기본 요청 URL:

## xml  
https://openapi.naver.com/v1/search/news.xml

## JSON
http://openapi.naver.com/vi/search/news.json

 

프로토콜 및 HTTP 메서드

  • HTTPS
  • GET

파라미터 설명:

파라미터 설명 예시 값
query 검색어 (필수) "오늘자 시사 및 경제 뉴스"
display 검색 결과 개수 (기본 10, 최대 100) 10
start 검색 시작 위치 (기본 1, 최대 1000) 1
sort 정렬 방법 (sim: 유사도순, date: 최신순) "date"

3. Postman에서 API 테스트 

개발 구현에 앞서 Postman에서 API 요청 시 제대로 값을 가져오는지 테스트해보자. 

 

1. Postman에서 새 요청 만들기

Postman을 열고 HTTP Request를 선택해 새 요청을 만든다.

Http Request(GET type)

2. Request Method & URL 설정

https://openapi.naver.com/v1/search/news.json

 

JSON 으로 할 예정이다. 

3. Headers 탭 설정하기 

Headers 탭을 클릭하고, 아래 값을 추가한다.

내 애플리케이션 에서 본 Client ID  Client Secret 값을 기입하면 된다.

KEY VALUE
X-Naver-Client-Id 네이버에서 발급받은 Client ID
X-Naver-Client-Secret 네이버에서 발급받은 Client Secret

 

Headers에 Client 정보 기입

4. Params 탭 설정하기 (Query 파라미터) 

Params 탭에서 적절한 파라미터를 설정한다. 

요청 URL 및 파라미터

 

5. 요청 실행 및 결과 확인하기

입력값 설정이 끝나면 “Send” 버튼을 눌러 요청을 실행하면 된다.

정상적으로 요청되었다면, JSON 형식으로 응답 결과를 확인할 수 있다.

API 요청 결과


요청이 실패한 경우 확인사항

  • 401 Unauthorized
    • 클라이언트 ID 및 Secret 키를 정확히 입력했는지 확인해봐야 한다.
  • 429 Too Many Requests
    • API 호출 제한 초과. Search API 같은 경우 비로그인 오픈 API 당일 사용량이 제한되어 있다. 일일허용량이 25000건이다. 참고해두자.

 

이렇게 하면 Postman으로 네이버 Search API를 쉽게 테스트할 수 있다. 이어서 다음 포스트에서 Python에서 네이버 API를 활용하는 부분을 구현할 것이다. 

 

반응형