# Throk API で Threads のキーワードをモニタリングする

キーワードモニタリングは通常 2 ステップで行います。まず `/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` を付けます（1 件につき 2 クレジット）。
- 返信を除いた通常の投稿だけを見たい場合：`post_type=thread`（`include_details=true` との併用が必要）。

## 2. 言及量のトレンドを見る

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 です。

## キーワード選びのコツ

キーワードはフレーズ全体で照合されるため、言葉の選び方が結果を直接左右します。ルールの全体は[検索ルール](/ja/api/guides/search-rules/)をご覧ください。ここではモニタリングでよく使うポイントを挙げます。

- **表記のバリエーションをすべて送る。** 例：`珍珠奶茶` と `珍奶`、`減肥` と `减肥`。`/post/search` は一度に最大 30 個のキーワードを送れ、キーワード同士は「または」の関係です。
- **英語は単語単位で照合される。** `AI` では「OpenAI」はヒットしません。探したい場合は `OpenAI` もリストに加えてください。
- **韓国語は助詞を考慮する。** `맛집` では「맛집에서」はヒットしません。よく使われる形もまとめて挙げてください。
- **1 文字だけのキーワードは避ける。** `茶` は「茶」を含むすべての投稿にヒットし、結果がノイズだらけになります。

## 新しい投稿を自動で通知する

API を定期的に呼び出したくない場合は、[Webhook](/ja/api/webhooks/) を設定しましょう。キーワードを含む投稿がいいね数、返信数、閲覧数のしきい値に達すると、Throk があなたのサーバーへ自動で送信します。

## AI アシスタントでモニタリングする

MCP を使えば、Claude にこの作業をそのまま頼めます。例：

> Throk で「珍珠奶茶」と「珍奶」の直近 30 日間の台湾での言及量の推移を調べて、いいね数が最も多い投稿を 5 件挙げて。

設定方法は[AI アシスタントで使う（MCP）](/ja/api/mcp/)をご覧ください。