用 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=zh-Hant' \
  --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=zh-Hant' \
  --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：這些串文的讚數、回覆數、轉發數（含引用）與分享數加總。這是每篇串文到 Throk 最後一次更新為止的累積數字，不是當天新增的互動

每天以台灣時間 00:00 切分。days 最多 90。

搜尋和趨勢請用同一個 language，兩邊的數字才對得上。沒有指定時預設為 zh，也就是所有中文串文（繁體、簡體與粵語）。

選關鍵字的訣竅

關鍵字是以完整片語比對，選字會直接影響結果。完整規則請見搜尋規則，這裡列出監測時最常用到的幾點：

把不同寫法都送出。 例如 珍珠奶茶 與 珍奶、減肥 與 减肥。/post/search 一次最多 30 個關鍵字，彼此是「或」的關係。
英文以單字比對。 AI 不會找到「OpenAI」，要找就把 OpenAI 也列進去。英文串文（en）會合併單複數，app 也會找到「apps」。
韓文要考慮助詞。 맛집 找不到「맛집에서」，請把常見變化一起列出。
避免單一個字。 茶 會找到所有含「茶」的串文，結果會很雜。

多種寫法的總聲量

每個關鍵字的趨勢線是各自計算的，同一篇串文可能同時出現在好幾條線裡，所以不能直接相加：

同一篇串文同時寫了「珍珠奶茶」和「珍奶」，兩條線各算一次。
一個關鍵字包含另一個時，短的已經涵蓋長的：奶茶 的數量已經包含所有提到「珍珠奶茶」的串文。

以 2026-09-22 的實測為例：珍珠奶茶 219 篇、珍奶 470 篇，相加是 689 篇，但同時提到其中任一個的串文實際是 679 篇；奶茶 則有 2,365 篇，已經包含那 219 篇「珍珠奶茶」。

所以把幾條線加起來，得到的是上限：實際的總數介於「最大的那條線」和「所有線的總和」之間。寫法之間很少同時出現時，總和會很接近實際數字。

需要準確的總數時，改用 /post/search：一次送出所有寫法（彼此是「或」，同一篇只算一次），時間設成同一天，size=1。回應中的 metadata.total_count 就是當天的串文數，每次 1 積分：

# 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=zh' \
  --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）。