Trends

지정한 쿼리에 대한 시간대별 트렌드를 계산한다.

Query

모든 category, section에 대해 트렌드 계산

GET /haystack/v1/_trends[?arg=value, ...]

특정 category의 모든 section에 대해 트렌드 계산

GET /haystack/v1/<string:category>/_trends[?arg=value, ...]

특정 category의 특정 section에 대해 트렌드 계산

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

URL Parameters

• query

  • 트렌드 계산에 사용할 검색 쿼리

• interval

  • 트렌드 계산 단위

    • 1y: 1년 단위

    • 1M: 1개월 단위

    • 1w: 1주일 단위

    • 1d: 1일 단위

    • 1h : 1시간 단위

    • 1m : 1분 단위

  • 계산 단위는 1 뿐 아니라, 다양한 단위로 처리할 수 있다.

    • 10m : 10분 단위

    • 3h : 3시간 단위

    • 5d : 5일 단위

• from / to

  • 트렌드 계산에 사용할 날짜 범위 (기본값: 전체)

Result

• key

  • 날짜

• value

  • 해당 기간의 모든 뉴스 대비 검색된 뉴스가 차지하는 비중

  • 전체 뉴스 개수가 증가하는 추세이므로 count보다는 value가 트렌드 비교 대상으로서 더 적합하다.

• count

  • 해당 기간에 포함된 검색된 뉴스의 수

Examples

전체 기간에 대해 북한 핵실험 트렌드를 1년 단위로 계산

api.ddi.deepsearch.com/haystack/v1/news/_trends?query=북한 핵실험&interval=1y

위 결과를 보면 2006년, 2009년, 2013년, 2016년 네 차례에 걸쳐서 북한이 핵실험을 했다는 사실을 추정해볼 수 있습니다. 이를 바탕으로 이제 2006년으로 범위를 좁혀서 월간 트렌드를 계산해보겠습니다.

2006년의 월간 북한 핵실험 트렌드

api.ddi.deepsearch.com/haystack/v1/news/_trends?query=북한 핵실험&interval=1M&from=20060101&to=20061231

위 결과를 통해 2006년 10월 중에 북한이 핵실험을 했다는 사실을 추정해볼 수 있습니다. 이제 다시 일간 트렌드를 통해 정확한 날짜를 확인해보겠습니다.

2006년 10월의 일간 북한 핵실험 트렌드

api.ddi.deepsearch.com/haystack/v1/news/_trends?query=북한 핵실험&interval=1d&from=20061001&to=20061031

위 결과를 통해 2016년 10월 9일에 북한 핵실험이 있었고, 이 이슈가 4-5일 가량 지속되었음을 알 수 있습니다.

Trends API 를 이용한 특정 주제에 대한 긍부정 점수 계산

긍부정 점수 = ( 긍정 뉴스 개수 - 부정 뉴스 개수 ) / ( 긍정 뉴스 개수 + 중립 뉴스 개수 + 부정 뉴스 개수 )

1. 삼성전자에 대한 긍정 뉴스 개수 추이
api.ddi.deepsearch.com/haystack/v1/news/_trends?query=삼성전자 polarity.label:1&interval=1M&from=20190101

2. 삼성전자에 대한 부정 뉴스 개수 추이
api.ddi.deepsearch.com/haystack/v1/news/_trends?query=삼성전자 polarity.label:-1&interval=1M&from=20190101

3. 삼성전자에 대한 중림 뉴스 개수 추이
api.ddi.deepsearch.com/haystack/v1/news/_trends?query=삼성전자 polarity.label:0&interval=1M&from=20190101