NEWSTORE 서비스매뉴얼

요청 URL

요청인자

• 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]
  기자의 이름을 조건으로 지정합니다. ※ 언론사에서 기자 이름을 제공한 News인 경우에만 검색이 가능합니다.
  예시) byline : 박광연
• subject_info[string]
  언론사에서 NewsML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다. ( ‘ , ’ 를 구분자로 나열할 수 있습니다)
• subject_info1[string]
  언론사에서 NewsML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다. ( ‘ , ’ 를 구분자로 나열할 수 있습니다)
• subject_info2[string]
  언론사에서 NewsML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다. ( ‘ , ’ 를 구분자로 나열할 수 있습니다)
• subject_info3[string]
  언론사에서 NewsML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다. ( ‘ , ’ 를 구분자로 나열할 수 있습니다)
• subject_info4[string]
  언론사에서 NewsML에 정의한 프로퍼티 SubjectInfo, SubjectInfo1~4의 내용을 검색합니다. ( ‘ , ’ 를 구분자로 나열할 수 있습니다)
• sort[string]
  검색된 뉴스기사의 정렬 방식을 지정합니다.
  • 지정하지 않으면, 기본값은 검색 정확도 순으로 조회됩니다.
  • 최신 기사 순서대로 조회 “ sort ” :{“ date ” : “ desc ”}
  • 과거 기사 순서대로 조회 “ sort ” :{“ date ” : “ asc ”}
  • 제목으로 정렬(제목은 오름차순으로만 정렬됩니다) “ sort ” :{“ title ” : “ asc ”}
  • 정확도 정렬(정확도는 내림차순으로만 정렬됩니다) “ sort ” :{“ _score ” : “ desc ”}
  • 최신순, 정확도순으로 다중정렬 “ sort ” :{“ date ” : “ desc ”}, {“ _score ” : “ desc ”}
  • 제목순, 날짜순으로 다중정렬 “ sort ” :{“ title ” : “ asc ”}, {“ date ” : “ asc ”}
  • 정렬로 지정가능한 필드와 정렬값
    • date : 날짜, desc / asc
    • title : 제목, asc
    • _score : 정확도, desc
    • byline : 기고자, asc
    • provider_code : 매체코드, desc / asc
• hilight[integer]
  기사에서 검색어가 포함된 영역을 찾아 지정한 범위(최대 200자)를 출력 결과로 제공합니다.
• return_from[integer]
  검색된 결과 목록에서 반환할 시작 위치를 지정합니다. return_from 필드는 최대 20,000까지만 가능합니다.
• return_size[integer]
  검색된 결과 목록에서 반환할 시작 위치부터 반환할 개수를 지정합니다.
  최대 10,000까지 가능합니다. 특정 언론사는 최대 15,000까지 제한을 두고 있습니다.
• fields[string]
  출력 결과에 반환할 필드 값을 지정합니다. 필요하지 않은 경우라도 비어 있는 배열( [] )을 입력해야 합니다.
  ※ 불필요한 데이터 전송을 줄이기 위해 지정하지 않은 필드의 값은 반환하지 않습니다.
  ※ 지정할 수 있는 값은 아래의 출력 결과형식의 documents 값을 참조하세요.
  예시) fields:byline,category,category_incident,images,content,provider_news_id,published_at

출력값

{
    "return_object": {
        "total_hits": 8,
        "documents": [
            {
                "news_id": "01400201.20210114085048001",
                "title": "[곽상훈 칼럼] 모바일 온리(Only) 시대 살기",
                "content": "'펜은 총보다 강하지만 밥은 펜보다 강하다.' 펜과 총이 세상 어느 것보다 강할 것처럼 보이지만 실은 '밥심'을 이기지 못한다는 뜻이다. 인기리에 방영되는 드라마 허쉬(HUSH)에서 정규직 전환을 앞둔 인턴기자의 좌우명이다. '사람들은 우리를 기자라 부르지만 여기(신문사)는 그냥 회사다'라고 한 주인공 말은 월급쟁이 기자의 모습을 떠올린다.\n참언론에 대한 진지한 질문을 던지지만 현실은 그렇지 않음을 깨닫게 해 준다. ",
                "published_at": "2021-01-14T00:00:00.000+09:00",
                "dateline": "2021-01-13T17:11:03.000+09:00",
                "provider": "대전일보",
                "category": [
                    "문화>출판",
                    "IT_과학>콘텐츠"
                ],
                "byline": "곽상훈",
                "images": "/01400201/2021/01/14/01400201.20210114085048001.01.jpg",
                "provider_news_id": "20210114_00_4897"
            }
        ]
    }
}