Historical Topics

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

과거 이슈(토픽) 검색

Query

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

Category 및 Section 옵션

  • Category / Section

    • 뉴스 : 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: 해당 토픽에 소속된 문서의 제목 리스트

Examples

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

api.ddi.deepsearch.com/haystack/v1/topics/history/news/politics,economy/_search?query=해운

2016.5.20 의 전체 토픽 추출:

api.ddi.deepsearch.com/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 추출:

api.ddi.deepsearch.com/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 추출:

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

개별 토픽의 상세 정보 확인

Query

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

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

Category 및 Section 옵션

  • Category / Section

    • 뉴스 : news

      • 전체 : all

      • 주요 : top

      • 정치 : politics

      • 경제 : economy

      • 사회 : society

      • 문화 : culture

      • 세계 : world

      • 기술/IT : tech

      • 연예 : entertainment

URL Parameters

  • uid : 상세 정보를 확인하고자 하는 토픽의 ID

  • fields : 연관 뉴스(docs) 의 세부 정보 중 어떤 것들만을 노출할것인지를 지정

  • summary: 연관 뉴스 content 를 요약할 것인지 설정

    • 1: 문서 요약, 0: 문서 요약하지 않음

    • 기본값: 1

  • sort

    • 연관 뉴스의 정렬 상태를 변경

    • similarity, uid 단독 또는 "," 로 연결하여 함께 사용 가능

    • -similarity, -uid 처럼 앞에 "-"를 붙이면 내림차순으로 정렬함

  • highlight_query: 검색 결과에 하이라이트할 키워드를 지정

Results

  • uid : 토픽 ID

  • uid_str : 토픽 ID 를 str 의 형태로 다시 표기

  • category : 현재는 news 카테고리만 토픽을 제공

  • section : 세부 섹션. 경제, 기술, 정치 등

  • rank : 토픽 순위

  • score : 토픽 점수로 클수록 viral 수치가 높다는 의미

  • topic : 토픽의 제목

  • keywords : 해당 토픽에서 주로 언급되고 있는 키워드 리스트

  • securities : 해당 토픽의 연관종목 리스트

  • entities: 해당 토픽에서 언급되고 있는 종목 리스트

  • docs : 해당 토픽에 소속된 뉴스 리스트

Examples

api.ddi.deepsearch.com/haystack/v1/topics/history/news/economy,world/551063820303470592,551107457519325184?fields=uid,securities,entities&sort=similarity

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

PreviousTrending TopicsNextAssociated Entities

Last updated

Was this helpful?