Historical Topics

Search API

과거 시장에서 벌어졌던 주요 이슈를 추출하여 제공한다.

GET /haystack/v1/topics/history/<string:category>/<string:section>/_search[?arg=value, ...]

Examples

여러 section을 지정하고자 하는 경우는 `,`를 사용한다. 예를 들어 `정치`, `경제` 뉴스 토픽을 검색하고자 하면 다음과 같이 지정한다:

GET /haystack/v1/topics/history/news/politics,economy/_search?query=해운

2016.5.20 의 전체 토픽 추출:

GET /haystack/v1/topics/history/news/all,top,politics,economy,society,culture,tech,world,entertainment/_search?query=*&from=2016-05-20&sort=section,rank

2016.8.1~2016.8.30 의 경제 토픽 TOP 10 추출:

GET /haystack/v1/topics/history/news/politics,economy/_search?query=*&count=10&from=2016-08-01&to=2016-08-30&sort=-score

삼성전자와 관련있는 2010.1.1~2015.12.3 의 정치, 경제 토픽 TOP 10 추출:

GET /haystack/v1/topics/history/news/politics,economy/_search?query=securities.name:삼성전자&count=10&from=2010-01-01&to=2015-12-31&sort=-score

Category 및 Section 옵션

  • Category

    • 뉴스 : news

  • Section

    • Category가 news일 경우

      • 전체 : all

      • 주요 : top

      • 정치 : politics

      • 경제 : economy

      • 사회 : society

      • 문화 : culture

      • 세계 : world

      • 기술/IT : tech

      • 연예 : entertainment

      전체 전체와 주요 섹션은 정치, 경제 등 다른 섹션들을 기반으로 생성되는 데이터이므로, 토픽이 중복 될 수 있음

URL Parameters

  • query
    • 검색어
  • count
    • 한 페이지에 표시할 문서의 최대 개수
  • page
    • 페이지 번호
  • from / to
    • 검색 대상 날짜 범위 지정 (기본값: 전체)
  • sort
    • 검색시 정렬의 기준이 되는 필드
    • 필드명 앞에 "-" 를 붙이면 내림차순으로 정렬됨
    • 여러 필드를 지정 할 수 있으며, 나열된 순서대로 정렬

Results

  • topics

    • 추출한 토픽 리스트
    • 개별 토픽의 구조는 다음과 같음:
      • uid : 토픽 ID
      • uid_str : 토픽 ID 를 str 의 형태로 다시 표기
      • category : 현재는 news 카테고리만 토픽을 제공
      • section : 세부 섹션. 경제, 기술, 정치 등
      • rank : 토픽 순위
      • score : 토픽 점수로 클수록 viral 수치가 높다는 의미
      • topic :토픽의 제목
      • keywords : 해당 토픽에서 주로 언급되고 있는 키워드 리스트
      • securities: 해당 토픽의 연관종목 리스트
      • entities: 해당 토픽에서 언급되고 있는 종목 리스트
      • titles: 해당 토픽에 소속된 문서의 제목 리스트

Topic API

Search API 에서 검된 토픽 각각에 대해서 상세 정보를 확인한다.

GET /haystack/v1/topics/history/<string:category>/<string:section>/<string:uid, ...[?arg=value, ...]

Examples

GET /haystack/v1/topics/history/news/economy,world/551063820303470592,551107457519325184?fields=uid,securities,entities&sort=similarity

Topic 중 economy 또는 world 섹션에 속해있는 uid 가 551063820303470592,551107457519325184 토픽에 대해서 상세 조회한다.

Category 및 Section 옵션

  • 상기 Search API 동일함

URL Parameters

  • uid : 상세 정보를 확인하고자 하는 토픽의 ID
  • fields : 연관 뉴스(docs) 의 세부 정보 중 어떤 것들만을 노출할것인지를 지정
  • summary: 연관 뉴스 content 를 요약할 것인지 설정 (1: 문서 요약, 0: 문서 요약하지 않음, 기본값: 1)
  • sort
    • 연관 뉴스의 정렬 상태를 변경
    • similarity, uid 단독 또는 "," 로 연결하여 함께 사용 가능
    • -similarity, -uid 처럼 앞에 "-"를 붙이면 내림차순으로 정렬함

Results

  • uid : 토픽 ID
  • uid_str : 토픽 ID 를 str 의 형태로 다시 표기
  • category : 현재는 news 카테고리만 토픽을 제공
  • section : 세부 섹션. 경제, 기술, 정치 등
  • rank : 토픽 순위
  • score : 토픽 점수로 클수록 viral 수치가 높다는 의미
  • topic : 토픽의 제목
  • keywords : 해당 토픽에서 주로 언급되고 있는 키워드 리스트
  • securities : 해당 토픽의 연관종목 리스트
  • entities: 해당 토픽에서 언급되고 있는 종목 리스트
  • docs : 해당 토픽에 소속된 뉴스 리스트

results matching ""

    No results matching ""