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=ko' \
  --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를 사용하세요.

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 'language=ko' \
  --data-urlencode 'days=30' \
  --data-urlencode 'include_engagement=true'

응답(일부):

{
  "results": [
    {
      "keyword": "다이어트",
      "trend": [
        {
          "date": "2026-09-22",
          "count": 1097,
          "like_count": 21480,
          "reply_count": 2870,
          "repost_count": 138,
          "reshare_count": 1045
        }
      ]
    }
  ],
  "credits_consumed": 240
}

• count: 그날(대만 시간) 게시되었고 이 키워드를 언급한 게시물 수(댓글 포함)
• like_count, reply_count, repost_count, reshare_count: 해당 게시물들의 좋아요 수, 댓글 수, 리포스트 수(인용 포함), 공유 수 합계. 각 게시물을 Throk이 마지막으로 업데이트한 시점까지의 누적 수치이며, 그날 새로 생긴 반응이 아닙니다

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

검색과 트렌드에는 같은 language를 사용해야 두 결과의 수치가 맞습니다. 지정하지 않으면 기본값 zh, 즉 모든 중국어 게시물(번체, 간체, 광둥어)이 대상이 됩니다. 한국어 게시물을 보려면 위 예시처럼 language=ko를 지정하세요.

최근 이틀의 수치는 아직 늘어납니다

• 마지막 날은 오늘이므로 지금까지의 수만 들어 있습니다.
• 새 게시물이 모두 수집되기까지 시간이 걸리므로, 이미 끝난 전날의 수치도 아직 늘어날 수 있습니다.
• 반응 수는 누적값이므로, 최근 며칠 사이에 게시된 게시물의 좋아요 수와 댓글 수는 계속 늘어나고 있습니다.

트렌드를 비교하거나 주간 보고서를 쓸 때는 최근 이틀을 제외하거나, 이틀 뒤에 다시 조회하세요.

키워드 선택 요령

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

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

여러 표기의 총 언급량

키워드마다 트렌드 선은 따로 계산됩니다. 같은 게시물이 여러 선에 동시에 들어갈 수 있으므로 선을 그대로 더하면 안 됩니다.

• 한 게시물에 「다이어트」와 「살빼기」가 모두 쓰여 있으면 두 선에 한 번씩 집계됩니다.
• 한 키워드가 다른 키워드를 포함하면 짧은 쪽이 긴 쪽을 이미 포함합니다. 다이어트의 수에는 「다이어트 식단」을 언급한 게시물이 모두 들어 있습니다.

2026-09-22에 language=ko로 실측한 예를 보면, 다이어트 1,097개와 살빼기 14개를 더하면 1,111개지만 둘 중 하나라도 언급한 게시물은 실제로 1,109개입니다. 2개는 두 단어를 모두 언급했기 때문입니다. 다이어트 식단은 25개인데, 이 25개는 모두 다이어트의 1,097개에 이미 들어 있습니다.

따라서 여러 선을 더한 값은 상한값입니다. 실제 총수는 「가장 큰 선」과 「모든 선의 합」 사이에 있습니다. 표기끼리 함께 쓰이는 경우가 드물면 합계가 실제 수와 매우 가깝습니다.

정확한 총수가 필요하면 /post/search를 사용하세요. 모든 표기를 한 번에 보내고(키워드끼리는 「또는」 관계이며 같은 게시물은 한 번만 집계), 기간을 같은 하루로 지정하고, size=1로 설정합니다. 응답의 metadata.total_count가 그날의 게시물 수이며, 호출당 1크레딧입니다. 위 실측의 1,109개도 아래 요청으로 얻은 값입니다.

# 2026-09-22(대만 시간) 하루 동안 「다이어트」 또는 「살빼기」를 언급한 한국어 게시물 수
curl -G 'https://premium-api.throk.ai/post/search' \
  -H 'Authorization: Bearer sk-throk-...' \
  --data-urlencode 'keywords=다이어트' \
  --data-urlencode 'keywords=살빼기' \
  --data-urlencode 'language=ko' \
  --data-urlencode 'from_timestamp=1790006400' \
  --data-urlencode 'to_timestamp=1790092799' \
  --data-urlencode 'size=1'

• from_timestamp와 to_timestamp는 모두 범위에 포함되므로, 하루는 00:00:00부터 23:59:59까지입니다.
• total_count는 최대 10,000까지만 표시됩니다. 하루 게시물이 그보다 많아도 10,000으로 표시됩니다.

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

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

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

MCP를 이용하면 Claude, ChatGPT 같은 AI 어시스턴트에게 바로 요청할 수 있습니다. 예:

Throk으로 「다이어트」와 「살빼기」의 최근 30일 한국어 게시물 언급량 추이를 조회하고, 좋아요 수가 가장 많은 게시물 5개를 나열해 줘.

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