개발자 매뉴얼

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

기본인자

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

요청인자

요청인자 표로 변수명, 타입, 변수설명 정보제공
변수명 타입 변수설명
query String 검색 질의어를 지정합니다.(검색어 없이 검색 가능)
from String 검색시작일 [yyyy-MM-dd]
until String 검색종료일 [yyyy-MM-dd]
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 알수없는 에러가 발생했습니다.

뉴스 보기

뉴스 구매하기

상품 옵션 선택

기사 단건 (웹·모바일)
기사 단건 (웹·모바일) 구매 목록이며 웹 및 모바일 게시용, 게재기간(1년, 2년, 3년, 4년 이상)정보를 제공하고 있습니다.
웹 및 모바일
게시용
게재기간
1년 2년 3년 4년 이상
비상업용
상업용
기사 단건 (출판·광고)
기사 단건 (출판·광고) 구매 목록이며 인쇄용, 인쇄부수(5천부미만, 5천부~1만부, 1만부~5만부, 5만부이상) 정보를 제공하고 있습니다.
인쇄용 인쇄부수
5천부미만 5천부~1만부 1만부~5만부 5만부이상
출판용
광고용
뉴스토어 크리에이터
  • 크리에이터 상품은 SNS, 동영상 등에 기사를 게재할 수 있는 상품입니다
  • 총 구독자수를 기준으로 정액제 상품이 구분되며 전국 88개 언론사의 뉴스저작물을 매월 5건씩 자유롭게 이용하실 수 있습니다.
    [뉴스토어 크리에이터 상품 자세히 보기]
뉴스토어 라이선스
  • 뉴스토어 라이선스 상품은 기관 및 기업용 월 정액제 상품입니다.
  • 사내 게시판에 이용할 수 있는 내부 라이선스와 대외 홍보용으로 홈페이지 등에 게재가 가능한 통합 라이선스 상품이 있습니다.
    [뉴스토어 라이선스 상품 자세히 보기]
  • 88개의 언론매체 중 원하시는 매체를 선택하여 서비스를 이용하실 수 있습니다.
0원 / /