키워드 트렌드 API

키워드와 언론사, 분류 조건을 통해 뉴스 데이터의 건수 집계를 제공합니다.

요청 URL

https://www.newstore.or.kr/api-newstore/v2/search/time_line.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]
    기자의 이름을 조건으로 지정합니다. ※ 언론사에서 기자 이름을 제공한 News인 경우에만 검색이 가능합니다.
    예시) byline : 박광연
  • interval[integer]
    집계할 기간을 지정합니다. [ day : 일자 별로 검색된 뉴스 건수를 집계합니다. , month : 월 별로 검색된 뉴스 건수를 집계합니다. , year : 년도 별로 검색된 뉴스 건수를 집계합니다.].
  • normalize[Boolean]
    boolean 값을 지정하여 정규화 수행여부 선택합니다.

출력값

  • total_hits
    검색된 전체 문서 건수를 반환합니다.
  • time_line
    기간별 조회된 뉴스 현황을 목록으로 반환합니다.
  • “label”
    집계기간으로, interval 값에 따라 형식이 달라집니다.
    day=yyyyMMdd,month=yyyyMM,year=yyyy
  • “hits”
    해당 기간에 조회조건으로 검색된 문서 건수
응답 
{
    "result": 0,
    "return_object": {
      "total_hits": 27,
      "time_line": [
        {
          "label": "201801",
          "hits": 2
        },
        {
          "label": "201802",
          "hits": 2
        },
        {
          "label": "201803",
          "hits": 2
        },
        {
          "label": "201804",
          "hits": 1
        },
        {
          "label": "201805",
          "hits": 6
        }
      ]
    }
  }