Throk API로 Threads 키워드 모니터링하기

키워드 모니터링은 보통 두 단계로 진행합니다. 먼저 /post/search로 어떤 게시물에서 이야기되고 있는지 보고, 이어서 /post/keyword-trend로 언급량이 어떻게 변하는지 봅니다.

1. 최근 이야기 찾기

최근 7일 동안 「珍珠奶茶」(버블티)를 언급한 대만 게시물을 좋아요 순으로 검색합니다.

curl -G 'https://premium-api.throk.ai/post/search' \
  -H 'Authorization: Bearer sk-throk-...' \
  --data-urlencode 'keywords=珍珠奶茶' \
  --data-urlencode 'language=tw' \
  --data-urlencode 'max_age_hours=168' \
  --data-urlencode 'sort=like:desc' \
  --data-urlencode 'size=20'

최신 이야기를 보려면 sort=timestamp:desc를 사용하세요.
작성자, 미디어, 리포스트 수도 함께 받으려면 include_details=true를 추가하세요(게시물당 2크레딧).
답글을 빼고 원글만 보려면 post_type=thread를 사용하세요(include_details=true와 함께 사용해야 함).

2. 언급량 트렌드 보기

두 키워드가 최근 30일 동안 매일 몇 번 언급되었는지 비교하고, 일별 참여 지표도 함께 받습니다.

curl -G 'https://premium-api.throk.ai/post/keyword-trend' \
  -H 'Authorization: Bearer sk-throk-...' \
  --data-urlencode 'keywords=珍珠奶茶' \
  --data-urlencode 'keywords=珍奶' \
  --data-urlencode 'days=30' \
  --data-urlencode 'include_engagement=true'

응답(일부):

{
  "results": [
    {
      "keyword": "珍珠奶茶",
      "trend": [
        {
          "date": "2026-09-22",
          "count": 412,
          "like_count": 18230,
          "reply_count": 1640,
          "repost_count": 95,
          "reshare_count": 3120
        }
      ]
    }
  ],
  "credits_consumed": 240
}

count: 그날 이 키워드를 언급한 게시물 수(답글 포함)
like_count, reply_count, repost_count, reshare_count: 해당 게시물들의 좋아요 수, 답글 수, 리포스트 수(인용 포함), 공유 수 합계

하루는 대만 시간 00:00 기준으로 나뉩니다. days는 최대 90입니다.

키워드 선택 요령

키워드는 완전한 구문으로 매칭되므로 어떤 단어를 고르느냐가 결과에 직접 영향을 줍니다. 전체 규칙은 검색 규칙을 참고하세요. 모니터링할 때 가장 자주 쓰는 요령은 다음과 같습니다.

다양한 표기를 모두 보내세요. 예: 珍珠奶茶와 珍奶, 減肥와 减肥. /post/search는 한 번에 최대 30개의 키워드를 받으며, 키워드끼리는 「또는」(OR) 관계입니다.
영어는 완전한 단어 단위로 매칭됩니다. AI로는 「OpenAI」를 찾지 못하므로, 필요하면 OpenAI도 목록에 넣으세요.
한국어는 조사를 고려하세요. 맛집으로는 「맛집에서」를 찾지 못하므로 자주 쓰는 변화형도 함께 넣으세요.
한 글자 키워드는 피하세요. 茶로 검색하면 「茶」가 들어간 모든 게시물이 나와 결과가 매우 지저분해집니다.

새 게시물이 올라오면 자동으로 알림 받기

API를 주기적으로 호출하고 싶지 않다면 Webhook을 설정하세요. 키워드가 포함된 게시물이 좋아요 수, 답글 수, 조회수 임계값에 도달하면 Throk이 서버로 바로 전송합니다.

AI 어시스턴트에서 모니터링하기

MCP를 이용하면 Claude에게 바로 요청할 수 있습니다. 예:

Throk으로 「珍珠奶茶」와 「珍奶」의 최근 30일 대만 언급량 추이를 조회하고, 좋아요 수가 가장 많은 게시물 5개를 나열해 줘.

설정 방법은 AI 어시스턴트에서 사용하기(MCP)를 참고하세요.