개발자 매뉴얼

요청주소 : https://www.newstore.or.kr/api/search/analysis.json

기본인자

기본인자 표로 변수명, 타입, 변수설명, 설명 정보제공
변수명 타입 설명
apiKey String API 요청 시 검증을 위한 키값

요청인자

요청인자 표로 변수명, 타입, 변수설명 정보제공
변수명 타입 변수설명
query String 검색 질의어를 지정합니다.(검색어 없이 검색 가능)
from String 검색시작일 [yyyy-MM-dd]
until String 검색종료일 [yyyy-MM-dd]
provider String 언론사를 지정합니다.(,를 구분자로 나열할 수 있습니다.)
category String 한국언론진흥재단에서 지정한 뉴스 통합 분류체계 값을 조건으로 지정합니다.(,를 구분자로 나열할 수 있습니다.)
category_incident String 한국언론진흥재단에서 지정한 뉴스 사건/사고 분류체계 값을 조건으로 지정합니다.(,를 구분자로 나열할 수 있습니다.)
provider_subject String 언론사에서 제공한 News의 주제 분류 값을 조건으로 지정 합니다.(,를 구분자로 나열할 수 있습니다.)
byline String 기자 이름을 조건으로 지정합니다.
subject_info String 언론사에서 NewML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다.(,를 구분자로 나열할 수 있습니다.)
subject_info1 String 언론사에서 NewML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다.(,를 구분자로 나열할 수 있습니다.)
subject_info2 String 언론사에서 NewML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다.(,를 구분자로 나열할 수 있습니다.)
subject_info3 String 언론사에서 NewML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다.(,를 구분자로 나열할 수 있습니다.)
subject_info4 String 언론사에서 NewML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다.(,를 구분자로 나열할 수 있습니다.)
sort String 검색된 뉴스기사의 정렬 방식을 지정합니다.
hilight Integer 기사에서 검색어가 포함된 영역을 찾아 지정한 범위(최대 200자)를 출력 결과로 제공합니다.
return_from Integer 검색된 결과 목록에서 반환할 시작 위치를 지정합니다. return_from 필드는 최대 20000까지만 가능합니다.
return_size Integer 검색된 결과 목록에서 반환할 시작 위치부터 반환할 개수를 지정합니다. 최대 10000까지 가능합니다. 특정 언론사는 최대 15000까지 제한을 두고 있습니다.
fields String 출력 결과에서 반환할 필드 값을 지정합니다.(,를 구분자로 나열할 수 있습니다.)

출력값

출력값 표로 No., 출력명, 설명 정보제공
출력명 설명
total_hits 검색된 전체 문서 건수를 반환합니다.
documents 요청인자값의 fields에서 지정한 필드들을 포함한 배열
documents[].news_id 언론진흥재단내에서 관리하는 뉴스 식별자입니다.
documents[].title 뉴스기사 제목
documents[].content 뉴스기사 본문
documents[].published_at 뉴스기사 발행일을 세계표준시간 기준으로 반환합니다.
documents[].enveloped_at 언론사로부터 뉴스기사를 수집한 시간
documents[].dateline 언론사로부터 전달받은 언론사의 뉴스 출고시간
documents[].provider 언론사
documents[].category 뉴스통합분류체계
documents[].hilight 검색어가 포함된 영역입니다. 요청파라메터에서 지정한 경우에만 반환합니다.
documents[].byline 기자 이름
documents[].images 이미지가 포함된 뉴스 기사의 경우 이미지 파일 이름을 반환
documents[].provider_subject 언론사에서 제공한 뉴스 분류 값(코드)
documents[].subject_info NewsML에서 정의한 프로퍼티 SubjectInfo 의 값
documents[].subject_info1 NewsML에서 정의한 프로퍼티 SubjectInfo1 의 값
documents[].subject_info2 NewsML에서 정의한 프로퍼티 SubjectInfo2 의 값)
documents[].subject_info3 NewsML에서 정의한 프로퍼티 SubjectInfo3 의 값
documents[].subject_info4 NewsML에서 정의한 프로퍼티 SubjectInfo4 의 값
documents[].provider_news_id 언론사에서 제공한 뉴스 고유 식별값
documents[].publisher_code 언론사에서 제공한 뉴스 고유 식별값
documents[].provider_link_page 언론사 원본 링크페이지(없는 경우 존재)
documents[].printing_page 지면번호(없는 경우 존재)

메시지 설명

메시지 설명 표로 구분, 코드, 설명 정보제공
구분 설명
ERROR 잘못된 API Key입니다.
ERROR 구매한 API호출수를 모두 소진했습니다.
ERROR 알수없는 에러가 발생했습니다.
요청주소 : https://www.newstore.or.kr/api/today-issue/analysis.json

기본인자

기본인자 표로 변수명, 타입, 변수설명, 설명 정보제공
변수명 타입 설명
apiKey String API 요청 시 검증을 위한 키값

요청인자

요청인자 표로 변수명, 타입, 변수설명 정보제공
변수명 타입 변수설명
date String 검색일자 [yyyy-MM-dd]
provider String 언론사를 지정합니다.(,를 구분자로 나열할 수 있습니다.)

출력값

출력값 표로 No., 출력명, 설명 정보제공
출력명 설명
date 조회된 일자를 반환합니다.
topics 분석된 이슈 키워드와 관련된 뉴스 식별자들을 중요도 순서로 10개를 반환합니다.
topics[].topic 뉴스에서 추출한 주요 이슈 키워드들
topics[].news_cluster 이슈와 관련된 뉴스들의 고유 식별자를 배열로 반환합니다.
topics[].topic_rank 내부적으로 순위를 부여하기 위한 일련 번호입니다. 숫자가 작을수록 중요한 이슈입니다.
topics[].topic_keyword 토픽랭크 알고리즘으로 뉴스에서 추출한 키워드

메시지 설명

메시지 설명 표로 구분, 코드, 설명 정보제공
구분 설명
ERROR 잘못된 API Key입니다.
ERROR 구매한 API호출수를 모두 소진했습니다.
ERROR 알수없는 에러가 발생했습니다.
요청주소 : https://www.newstore.or.kr/api/relate-word/analysis.json

기본인자

기본인자 표로 변수명, 타입, 변수설명, 설명 정보제공
변수명 타입 설명
apiKey String API 요청 시 검증을 위한 키값

요청인자

요청인자 표로 변수명, 타입, 변수설명 정보제공
변수명 타입 변수설명
query String 관련된 키워드를 추출하기 위한 키워드를 지정합니다.
from String 검색시작일 [yyyy-MM-dd]
until String 검색종료일 [yyyy-MM-dd]
provider String 언론사를 지정합니다.(,를 구분자로 나열할 수 있습니다.)
category String 한국언론진흥재단에서 지정한 뉴스 통합 분류체계 값을 조건으로 지정합니다.(,를 구분자로 나열할 수 있습니다.)
category_incident String 한국언론진흥재단에서 지정한 뉴스 사건/사고 분류체계 값을 조건으로 지정합니다.(,를 구분자로 나열할 수 있습니다.)
provider_subject String 언론사에서 제공한 News의 주제 분류 값을 조건으로 지정 합니다.(,를 구분자로 나열할 수 있습니다.)
byline String 기자 이름을 조건으로 지정합니다.

출력값

출력값 표로 No., 출력명, 설명 정보제공
출력명 설명
nodes 지정한 검색어와 연관된 키워드들을 반환합니다.
nodes[].name 토픽명칭을 반환합니다.
nodes[].weight 토픽의 중요도를 수치로 반환합니다.(하단 TOPIC RANK 알고리즘 참고)
nodes[].id 토픽들을 구분하기 위한 식별자입니다.
nodes[].level 지정한 검색어와 토픽간의 연결 단계를 나타냅니다. 그래프 분석을 위한 예약어로 워드 크라우드에서는 무시하셔도 됩니다.

메시지 설명

메시지 설명 표로 구분, 코드, 설명 정보제공
구분 설명
ERROR 잘못된 API Key입니다.
ERROR 구매한 API호출수를 모두 소진했습니다.
ERROR 알수없는 에러가 발생했습니다.
요청주소 : https://www.newstore.or.kr/api/keyword-trend/analysis.json

기본인자

기본인자 표로 변수명, 타입, 변수설명, 설명 정보제공
변수명 타입 설명
apiKey String API 요청 시 검증을 위한 키값

요청인자

요청인자 표로 변수명, 타입, 변수설명 정보제공
변수명 타입 변수설명
query String 검색 질의어를 지정합니다.(검색어 없이 검색 가능)
from String 검색시작일 [yyyy-MM-dd]
until String 검색종료일 [yyyy-MM-dd]
provider String 언론사를 지정합니다.(,를 구분자로 나열할 수 있습니다.)
category String 한국언론진흥재단에서 지정한 뉴스 통합 분류체계 값을 조건으로 지정합니다.(,를 구분자로 나열할 수 있습니다.)
category_incident String 한국언론진흥재단에서 지정한 뉴스 사건/사고 분류체계 값을 조건으로 지정합니다.(,를 구분자로 나열할 수 있습니다.)
provider_subject String 언론사에서 제공한 News의 주제 분류 값을 조건으로 지정 합니다.(,를 구분자로 나열할 수 있습니다.)
byline String 기자 이름을 조건으로 지정합니다.
interval Integer 집계할 기간을 지정합니다.[day : 일자 별로 검색된 뉴스 건수를 집계합니다., month : 월 별로 검색된 뉴스 건수를 집계합니다., year : 년도 별로 검색된 뉴스 건수를 집계합니다.].
normalize Boolean boolean 값을 지정하여 정규화 수행여부 선택.

출력값

출력값 표로 No., 출력명, 설명 정보제공
출력명 설명
total_hits 검색된 전체 문서 건수를 반환합니다.
time_line 기간별 조회된 뉴스 현황을 목록으로 반환합니다.
time_line[].label 집계기간으로, interval 값에 따라 형식이 달라집니다.
day=yyyyMMdd,month=yyyyMM,year=yyyy
time_line[].hits 해당 기간에 조회조건으로 검색된 문서 건수

메시지 설명

메시지 설명 표로 구분, 코드, 설명 정보제공
구분 설명
ERROR 잘못된 API Key입니다.
ERROR 구매한 API호출수를 모두 소진했습니다.
ERROR 알수없는 에러가 발생했습니다.
요청주소 : https://www.newstore.or.kr/api/keyword-ranking/analysis.json

기본인자

기본인자 표로 변수명, 타입, 변수설명, 설명 정보제공
변수명 타입 설명
apiKey String API 요청 시 검증을 위한 키값

요청인자

요청인자 표로 변수명, 타입, 변수설명 정보제공
변수명 타입 변수설명
from String 검색시작일 [yyyy-MM-dd]
until String 검색종료일 [yyyy-MM-dd]
offset Integer 결과값으로 전달받을 개수를 지정합니다.

출력값

출력값 표로 No., 출력명, 설명 정보제공
출력명 설명
queries 요청결과 배열
queries[].date 조회일자
queries[].query 키워드
documents[].count 키워드 포함 횟수

메시지 설명

메시지 설명 표로 구분, 코드, 설명 정보제공
구분 설명
ERROR 잘못된 API Key입니다.
ERROR 구매한 API호출수를 모두 소진했습니다.
ERROR 알수없는 에러가 발생했습니다.
요청주소 : https://www.newstore.or.kr/api/today-keyword/analysis.json

기본인자

기본인자 표로 변수명, 타입, 변수설명, 설명 정보제공
변수명 타입 설명
apiKey String API 요청 시 검증을 위한 키값

요청인자

요청인자 표로 변수명, 타입, 변수설명 정보제공
변수명 타입 변수설명
기본인자 외의 요청인자가 없습니다.

출력값

출력값 표로 No., 출력명, 설명 정보제공
출력명 설명
date 오늘 날짜 정보를 반환합니다.
cate_ratio 오늘의 키워드 카테고리 정보를 JSON 객체의 배열로 반환합니다.
cate_ratio[].category_percent 카테고리 전체 퍼센테이지 정보를 반환합니다.
cate_ratio[].category_name 카테고리명 정보를 반환합니다.
cate_ratio[].category_code 카테고리 내부 고유코드값을 반환합니다.
cate_ratio[].category_count 카테고리 개수를 반환합니다.
cate_keyword 오늘의 키워드 카테고리 정보를 JSON 객체의 배열로 반환합니다.
cate_keyword[].category_name 카테고리명 정보를 반환합니다.
cate_keyword[].category_code 카테고리 내부 고유코드값을 반환합니다.
cate_keyword[].named_entity 오늘의 키워드 명을 반환합니다.
cate_keyword[].named_entity_count 오늘의 키워드 개수를 반환합니다.
cate_keyword[].named_entity_type 오늘의 키워드 개체타입을 반환합니다.
(PS : 인물, LC : 장소, OG:기관)
cate_keyword[].entity_step step1~step5을 반환합니다.
해당 정보를 이용해서 UI에서 글자크기로 표시하기 위한 목적.
(step1 : 10개 미만, step2 : 20개 미만, step3 : 50개 미만, step4 : 100개 미만, step5 100개 이상)

메시지 설명

메시지 설명 표로 구분, 코드, 설명 정보제공
구분 설명
ERROR 잘못된 API Key입니다.
ERROR 구매한 API호출수를 모두 소진했습니다.
ERROR 알수없는 에러가 발생했습니다.
요청주소 : https://www.newstore.or.kr/api/topn-keyword/analysis.json

기본인자

기본인자 표로 변수명, 타입, 변수설명, 설명 정보제공
변수명 타입 설명
apiKey String API 요청 시 검증을 위한 키값

요청인자[유형 1]

요청인자 표로 변수명, 타입, 변수설명 정보제공
변수명 타입 변수설명
date_hour String yyyyMMddHH 형식으로 조회할 날짜시간을 지정합니다.
지정한 날짜시간으로부터 24시간전까지 조회합니다.

요청인자[유형 2]

요청인자 표로 변수명, 타입, 변수설명 정보제공
변수명 타입 변수설명
query String 검색 질의어를 지정합니다.
from String 검색시작일 [yyyy-MM-dd]
until String 검색종료일 [yyyy-MM-dd]
category String 뉴스 통합 분류체계(정치, 경제, 사회, 문화, 국제, 지역, 스포츠, IT 과학) 코드 값을 조건으로 지정합니다.(,를 구분자로 나열할 수 있습니다.)
[정치 : 001000000, 경제 : 002000000, 사회 : 003000000, 문화 : 004000000, 국제 : 005000000, 지역 : 006000000, 스포츠 : 007000000, IT_과학 : 008000000]

출력값

출력값 표로 No., 출력명, 설명 정보제공
출력명 설명
result 결과 배열
result[].rank 키워드 언급량 순위입니다.
result[].name 언급된 키워드입니다.
result[].content 본문 텍스트에 대한 키워드 추출 결과를 반환합니다.

메시지 설명

메시지 설명 표로 구분, 코드, 설명 정보제공
구분 설명
ERROR 잘못된 API Key입니다.
ERROR 구매한 API호출수를 모두 소진했습니다.
ERROR 알수없는 에러가 발생했습니다.