Trending Topics API
Query
현재 시장에서 벌어지고 있는 주요 이슈를 추출하여 제공한다.
GET /haystack/v1/topics/trending/news
URL Parameters
- input parameter 없이 URL 을 그대로 호출한다. 호출 시점에서 가장 최신의 이슈를 제공한다.
Results
- timestamp
- 토픽을 추출한 시간. 매 10분 단위로 토픽을 추출한다.
- Topics
- 추출한 토픽 리스트
- 제공 섹션
- top : 주
- society : 사회
- all : 전체
- politics : 정치
- culture : 문화
- entertainment : 연예
- world : 세계
- economy : 경제
- tech : 기술
- 개별 토픽은 아래의 파라미터를 가진다.
- uid : 토픽 ID
- uid_str : 토픽 ID 를 str 의 형태로 다시 표기
- category : 현재는 news 를 기반으로만 토픽을 제공한다.
- section : 세부 섹션. 경제, 기술, 정치 등
- rank : 토픽 순위
- score : 토픽 점수. 점수가 클수록 viral 수치가 높다는 의미이다.
- topic : 기계적으로 작성한 토픽의 제목
- keywords : 해당 토픽에서 주로 언급되고 있는 키워드 리스트
Topic API
trending topics 에서 추출된 토픽 각각에 대해서 상세 정보를 확인한다.
GET /haystack/v1/topics/<string:category>/<string:section>/<string:uid, ...[?arg=value, ...]
Examples
api.snek.ai/haystack/v1/topics/news/politics,economy/64194,2078053?fields=uid,securities,entities
Topic 중 politics 및 economy 섹션에 속해있는 uid 가 64194, 2078053 토픽에 대해서, 토픽 id 와 관련 주식명, 언급 기업명을 리턴한다.
URL Parameters
- uid : 상세 정보를 확인하고자 하는 토픽의 id
- fields : 결과로 나타나는 docs 의 세부 정보 중 어떤 것들만을 노출할것인지를 지정.
Results
- uid : 토픽 ID
- uid_str : 토픽 ID 를 str 의 형태로 다시 표기
- category : 현재는 news 를 기반으로만 토픽을 제공한다.
- section : 세부 섹션. 경제, 기술, 정치 등
- rank : 토픽 순위
- score : 토픽 점수. 점수가 클수록 viral 수치가 높다는 의미이다.
- topic : 기계적으로 작성한 토픽의 제목
- keywords : 해당 토픽에서 주로 언급되고 있는 키워드 리스트
- docs : 해당 토픽에 대해서 연결된 뉴스 리스트