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

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

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

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 もリストに加えてください。
• 韓国語は助詞を考慮する。 맛집 では「맛집에서」はヒットしません。よく使われる形もまとめて挙げてください。
• 1 文字だけのキーワードは避ける。 茶 は「茶」を含むすべての投稿にヒットし、結果がノイズだらけになります。

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

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

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

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

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

設定方法はAI アシスタントで使う（MCP）をご覧ください。