요청주소 : 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 | 출력 결과에서 반환할 필드 값을 지정합니다.(,를 구분자로 나열할 수 있습니다.) |
출력값
출력명 | 설명 |
---|---|
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 | 언론사를 지정합니다.(,를 구분자로 나열할 수 있습니다.) |
출력값
출력명 | 설명 |
---|---|
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 | 기자 이름을 조건으로 지정합니다. |
출력값
출력명 | 설명 |
---|---|
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 값을 지정하여 정규화 수행여부 선택. |
출력값
출력명 | 설명 |
---|---|
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 | 결과값으로 전달받을 개수를 지정합니다. |
출력값
출력명 | 설명 |
---|---|
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 요청 시 검증을 위한 키값 |
요청인자
변수명 | 타입 | 변수설명 |
---|---|---|
기본인자 외의 요청인자가 없습니다. |
출력값
출력명 | 설명 |
---|---|
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] |
출력값
출력명 | 설명 |
---|---|
result | 결과 배열 |
result[].rank | 키워드 언급량 순위입니다. |
result[].name | 언급된 키워드입니다. |
result[].content | 본문 텍스트에 대한 키워드 추출 결과를 반환합니다. |
메시지 설명
구분 | 설명 |
---|---|
ERROR | 잘못된 API Key입니다. |
ERROR | 구매한 API호출수를 모두 소진했습니다. |
ERROR | 알수없는 에러가 발생했습니다. |