# 用 Throk API 監測 Threads 關鍵字

關鍵字監測通常分兩步：先用 `/post/search` 看**有哪些串文**在討論，再用 `/post/keyword-trend` 看**聲量怎麼變化**。

## 1. 找出最近的討論

搜尋最近 7 天、提到「珍珠奶茶」的台灣串文，依讚數排序：

```bash
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 天每天被提到幾次，並附上每日互動數：

```bash
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'
```

回應（節錄）：

```json
{
  "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。

## 選關鍵字的訣竅

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

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

## 有新串文時自動通知

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

## 在 AI 助手裡做監測

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

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

設定方式請見[在 AI 助手中使用（MCP）](/api/mcp/)。