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

모든 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일 단위

  • from / to

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

Result

  • key

    • 날짜

  • value

    • 해당 기간의 모든 뉴스 대비 검색된 뉴스가 차지하는 비중
    • 전체 뉴스 개수가 증가하는 추세이므로 count보다는 value가 트렌드 비교 대상으로서 더 적합하다.

  • count

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

Examples

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

curl -XGET 'https://api.snek.ai/haystack/v1/news/_trends?query=북한 핵실험&interval=1y' \
     -u {user_id}:{password}

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

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

curl -XGET 'https://api.snek.ai/haystack/v1/news/_trends?query=북한 핵실험&interval=1M&from=20060101&to=20061231' \
     -u {user_id}:{password}

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

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

curl -XGET 'https://api.snek.ai/haystack/v1/news/_trends?query=북한 핵실험&interval=1d&from=20061001&to=20061031' \
     -u {user_id}:{password}

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

results matching ""

    No results matching ""