[.Net] C#에서 네이버 뉴스 REST API로 원하는 뉴스만 수집하기 (예제 포함)

네이버 뉴스 REST API / 오픈 API

지난 포스팅에서 Open API를 사용하여 C#에서 고속도로 교통량 정보를 얻는 방법을 소개했었습니다.

[C#] Open API 고속도로 교통량 정보 얻기 (예제 포함)

[C#] Open API 고속도로 교통량 정보 얻기 (예제 포함)

네이버도 마찬가지로 이러한 Open API를 제공하며, 신청 허가만 된다면 누구나 네이버 Open API를 사용할 수 있습니다. 예를 들어, 네이버 뉴스 Open API를 사용하여 원하는 키워드가 포함된 뉴스만 수집하는 것이 가능합니다. 사실 네이버 Open API는 뉴스뿐만 아니라 블로그, 백과사전, 지식iN, 오타 변환 등의 서비스 API도 제공합니다. 사용하는 방법만 안다면 원하는 것은 다 만들 수 있습니다.

네이버 오픈API 서비스 종류

본문에서는 네이버 Open API 이용 신청 방법과 C#에서 특정 키워드가 포함된 뉴스만 수집하는 방법을 소개하겠습니다.

네이버 오픈 API 이용 신청하기

아래 링크에 접속하여 오픈 API 이용 신청 버튼을 클릭합니다.

developers.naver.com/products/service-api/datalab/datalab.md

데이터랩 - SERVICE-API

오픈 API 이용 신청

아래와 같이 환영 메시지가 표시됩니다. 확인 버튼 클릭 후 약관에 동의합니다.

약관 동의 화면

휴대폰 및 이메일 정보 입력 화면입니다. 회사 이름은 선택이며, 개인이 개발하는 것이라면 입력하지 않아도 됩니다.

계정 설정 화면

애플리케이션 등록(API 이용신청) 화면입니다. 애플리케이션 이름과 사용하고 싶은 API와 서비스 환경(Web, iOS, Android)을 선택합니다.

애플리케이션 등록 화면

문제 없이 등록됐다면, 아래와 같이 내 애플리케이션에 Client ID와 Secret 정보가 표시됩니다.

애플리케이션 확인 화면

네이버 API 뉴스 검색 요청과 결과 분석 방법

1. 요청 방법

네이버 API 뉴스 검색 개발 가이드에 아래와 같은 정보를 제공하고 있습니다.

뉴스 검색 API 개발 가이드 - 기본 정보 및 요청 변수

API 기본 정보는 아래와 같습니다. 

메서드	인증	요청 URL	출력 포맷
GET	-	https://openapi.naver.com/v1/search/news.xml	XML
GET	-	https://openapi.naver.com/v1/search/news.json	JSON

즉, XML 포맷으로 데이터를 받고 싶다면 https://openapi.naver.com/v1/search/news.xml URL을 GET 메서드로 호출하고, JSON 포맷으로 데이터를 받고 싶다면 https://openapi.naver.com/v1/search/news.json URL을 GET 메서드로 호출하라는 의미입니다. 그리고 인증이 필요 없습니다.

요청 변수는 다음과 같습니다.

요청 변수	타입	필수 여부	기본값	설명
query	string	Y	-	검색을 원하는 문자열로서 UTF-8로 인코딩한다.
display	integer	N	10(기본값), 100(최대)	검색 결과 출력 건수 지정.
start	integer	N	1(기본값), 1000(최대)	검색 시작 위치로 최대 1000까지 가능.
sort	string	N	sim, date(기본값)	정렬 옵션: sim (유사도순), date (날짜순).

검색어(query)는 반드시 사용해야 하고 나머지 display, start, sort는 필수가 아니므로 선택적으로 옵션을 추가할 수 있다는 의미입니다.

위 API 기본 정보와 요청 변수를 어떻게 사용해야 하는지 예시를 들겠습니다.

• JSON 포맷 요청
• 키워드: 경제
• 검색 결과 출력 수: 40건
• 검색 시작 위치: 1
• 정렬 옵션: 유사도순

요청 URL: https://openapi.naver.com/v1/search/news.json?query=경제&display=40&start=1&sort=sim

2. 결과 분석 방법

출력 결과는 다음과 같습니다.

뉴스 검색 API 개발 가이드 - 출력 결과

필드	타입	설명
rss	-	디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없다.
channel	-	검색 결과를 포함하는 컨테이너이다. 이 안에 있는 title, link, description 등의 항목은 참고용으로 무시해도 무방하다.
lastBuildDate	datetime	검색 결과를 생성한 시간이다.
total	integer	검색 결과 문서의 총 개수를 의미한다.
start	integer	검색 결과 문서 중, 문서의 시작점을 의미한다.
display	integer	검색된 검색 결과의 개수이다.
item/items	-	XML 포멧에서는 item 태그로, JSON 포멧에서는 items 속성으로 표현된다. 개별 검색 결과이며 title, originallink, link, description, pubDate를 포함한다.
title	string	개별 검색 결과이며, title, originallink, link, description, pubDate 를 포함한다.
originallink	string	검색 결과 문서의 제공 언론사 하이퍼텍스트 link를 나타낸다.
link	string	검색 결과 문서의 제공 네이버 하이퍼텍스트 link를 나타낸다.
description	string	검색 결과 문서의 내용을 요약한 패시지 정보이다. 문서 전체의 내용은 link를 따라가면 읽을 수 있다. 패시지에서 검색어와 일치하는 부분은 태그로 감싸져 있다.
pubData	datetime	검색 결과 문서가 네이버에 제공된 시간이다.

JSON 포맷으로 요청한 결과 예시는 다음과 같습니다.

{
"lastBuildDate": "Wed, 17 Mar 2021 19:11:36 +0900",
"total": 219158,
"start": 1,
"display": 10,
"items": [
{
"title": "대전 자치구 축제 개최 '조심스러운 타진'",
"originallink": "http://www.ggilbo.com/news/articleView.html?idxno=834720",
"link": "http://www.ggilbo.com/news/articleView.html?idxno=834720",
"description": "&lt;<b>속보</b>&gt;=지난해 코로나19로 올스톱된 대전 지역 축제들이 올해는 조금씩 개최될 기미를 보이고 있다. 대전에선 코로나19 감염이 소강 국면을 맞이하기도 했으며 백신 접종으로 집단면역이 형성될 것으로 기대되자 지역 <b>경제</b>... ",
"pubDate": "Wed, 17 Mar 2021 19:02:00 +0900"

},
{
"title": "[<b>속보</b>] 농림어업인도 가구당 100만 원 재난지원금...추경 1.6조 증액",
"originallink": "https://hankookilbo.com/News/Read/A2021031717550004609?did=NA",
"link": "https://news.naver.com/main/read.nhn?mode=LSD&mid=sec&sid1=100&oid=469&aid=0000589056",
"description": "추경 증액 결정은 신종 코로나바이러스 감염증(코로나19)으로 인한 경기 침체와 꽃 농가 타격 등 <b>경제</b>적... 이들은 “코로나19로 <b>경제</b>적 이중고를 경험하고 있는 농림어업인에 대한 재난지원금 지원 방안이 빠진 데... ",
"pubDate": "Wed, 17 Mar 2021 18:27:00 +0900"

},
 //...
]
}

C#으로 네이버 뉴스 검색 프로그램 만들기

이제 본격적으로 C#으로 프로그램을 만들어 보겠습니다. ExamNaverOpenAPI 이름의 Windows Forms앱 프로젝트를 생성합니다.

Windows Forms 앱 프로젝트 생성하기

UI는 아래와 같이 배치합니다. 키워드, 출력 수, 정렬 방법에 기본 값을 입력하도록 했습니다. 뉴스 조회 결과는 리스트 뷰에 표시되도록 할 예정입니다.

뉴스 검색 프로그램 UI 예시

이제 네이버 오픈 API에 어떻게 요청하는지 코드를 살펴보겠습니다.

private string getResults()
{
	string keyword = textBoxKeyword.Text; //검색어
	string display = trackBarDisplayCounts.Value.ToString(); //출력 표시 수
	string sort = "sim"; //정렬 방법(유사도)
	if (radioButtonDate.Checked == true)
		sort = "date"; //정렬 방법(날짜)

	string query = string.Format("?query={0}&display={1}sort={2}", keyword, display, sort); //쿼리 만들기

	WebRequest request = WebRequest.Create(_apiUrl + query); //요청 URL에 쿼리 붙여 보내기
	request.Headers.Add("X-Naver-Client-Id", _clientId); //자신의 Application ID 입력
	request.Headers.Add("X-Naver-Client-Secret", _clientSecret); //자신의 Application Secret 입력

	string requestResult = "";
	using (var response = request.GetResponse())
	{
		using (Stream dataStream = response.GetResponseStream())
		{
			using (var reader = new StreamReader(dataStream))
			{
				requestResult = reader.ReadToEnd(); //결과 읽어내기
			}
		}
	}
		
	return requestResult; //결과 반환
}

앞서 설명한 대로, 옵션 선택에 따라 쿼리를 구성하고 해당 URL을 요청하면 특정 포맷으로 결과를 반환하게 됩니다. JSON으로 요청한 결과는 아래 코드와 같이 파싱(Parsing)이 가능합니다. 참고로 JSON 파싱은 누겟(Nuget)에서 Newtonsoft.Json 라이브러리를 사용했습니다.

private void buttonUpdate_Click(object sender, EventArgs e)
{
	try
	{
		string results = getResults(); //요청한 결과 반환
		//HTML 태그 제거 및 변경
		results = results.Replace("<b>", "");
		results = results.Replace("</b>", "");
		results = results.Replace("&lt;", "<");
		results = results.Replace("&gt;", ">");

		var parseJson = JObject.Parse(results);
		var countsOfDisplay = Convert.ToInt32(parseJson["display"]);
		var countsOfResults = Convert.ToInt32(parseJson["total"]);

		listViewResults.Items.Clear();
		for (int i=0; i< countsOfDisplay; i++)
		{
			ListViewItem item = new ListViewItem((i+1).ToString());
			
			var title = parseJson["items"][i]["title"].ToString();
			title = title.Replace("&quot;", "\""); //HTML 태그 변경

			var description = parseJson["items"][i]["description"].ToString();
			description = description.Replace("&quot;", "\""); //HTML 태그 변경

			var link = parseJson["items"][i]["link"].ToString();

			//뉴스 제목, 본문, 링크를 리스트 뷰에 추가
			item.SubItems.Add(title);
			item.SubItems.Add(description);
			item.SubItems.Add(link);

			listViewResults.Items.Add(item);
		}
	}
	catch (Exception exc)
	{
		Debug.WriteLine(exc.Message);
	}
}

요청한 결과를 받아보면, 뉴스 제목, 본문에 불필요한 HTML 태그가 포함되어 있습니다. <b>라든가 " 같은 것들인데요. 강조 표시인 <b></b> 태그는 필요 없으니 제거하고, " 와 <, >는 특수문자로 치환되도록 했습니다.

그리고 각 뉴스의 제목(title)과 본문(description), 링크(link)를 파싱하여 리스트 뷰에 보이도록 추가하는 것이 전부입니다. 결과를 보겠습니다.

프로그램 실행 결과

자세한 코드 사용은 아래의 샘플 코드를 참고하세요.

ExamNaverOpenAPI.zip

4.78MB