用 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 個關鍵字，彼此是「或」的關係。
• 英文以完整單字比對。 AI 不會找到「OpenAI」，要找就把 OpenAI 也列進去。
• 韓文要考慮助詞。 맛집 找不到「맛집에서」，請把常見變化一起列出。
• 避免單一個字。 茶 會找到所有含「茶」的串文，結果會很雜。

有新串文時自動通知

不想定時呼叫 API？設定 Webhook，關鍵字串文達到讚數、回覆數或瀏覽數門檻時，Throk 會主動推送到你的伺服器。

在 AI 助手裡做監測

透過 MCP，可以直接請 Claude 幫你做這件事，例如：

用 Throk 查「珍珠奶茶」和「珍奶」最近 30 天在台灣的聲量趨勢，並列出讚數最高的 5 篇串文。

設定方式請見在 AI 助手中使用（MCP）。