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=ja' \
  --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。

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 'language=ja' \
  --data-urlencode 'days=30' \
  --data-urlencode 'include_engagement=true'

レスポンス（抜粋）：

{
  "results": [
    {
      "keyword": "ダイエット",
      "trend": [
        {
          "date": "2026-09-22",
          "count": 2687,
          "like_count": 96540,
          "reply_count": 8120,
          "repost_count": 410,
          "reshare_count": 5230
        }
      ]
    }
  ],
  "credits_consumed": 240
}

count：その日（台湾時間）に投稿され、このキーワードに言及した投稿の数（リプライを含む）
like_count、reply_count、repost_count、reshare_count：それらの投稿のいいね数、リプライ数、リポスト数（引用を含む）、シェア数の合計。各投稿について Throk が最後に更新した時点までの累計値で、その日に増えたエンゲージメントではありません

日付は台湾時間の 00:00 で区切ります。days は最大 90 です。

検索とトレンドには同じ language を指定してください（この例ではどちらも ja）。そうすることで両方の数値が一致します。指定しない場合のデフォルトは zh、つまりすべての中国語の投稿（繁体字・簡体字・広東語）です。

キーワード選びのコツ

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

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

複数の表記を合わせた言及量

キーワードごとのトレンドラインは個別に算出されます。同じ投稿が複数のラインに同時に数えられることがあるため、そのまま足し合わせることはできません。

1 つの投稿に「ダイエット」と「減量」の両方が書かれていれば、2 つのラインでそれぞれ 1 回ずつ数えられます。
あるキーワードが別のキーワードを含む場合は、短いほうが長いほうをすでにカバーしています。ダイエット の件数には、「ダイエット中」に言及したすべての投稿が含まれます（カタカナ語が漢字の「中」の手前で終わるため。検索ルールを参照）。

2026-09-22 の実測例（language=ja）：ダイエット は 2,687 件、減量 は 305 件で、合計すると 2,992 件ですが、どちらかに言及した投稿は実際には 2,944 件でした（下記の /post/search による集計。48 件は両方に言及）。ダイエット中 は 267 件ありますが、これらはすべて ダイエット の 2,687 件にすでに含まれています。

つまり、複数のラインを足し合わせた値は上限です。実際の総数は「最も大きいライン」と「すべてのラインの合計」の間になります。表記同士が同じ投稿に一緒に出てくることが少なければ、合計は実際の数にかなり近くなります。

正確な総数が必要な場合は /post/search を使います。すべての表記を一度に送信し（キーワード同士は「または」の関係で、同じ投稿は 1 回だけ数えられます）、期間を同じ 1 日に設定して size=1 を指定します。レスポンスの metadata.total_count がその日の投稿数で、1 回につき 1 クレジットです。

# 2026-09-22（台湾時間）の 1 日で、「ダイエット」または「減量」に言及した日本語の投稿数
curl -G 'https://premium-api.throk.ai/post/search' \
  -H 'Authorization: Bearer sk-throk-...' \
  --data-urlencode 'keywords=ダイエット' \
  --data-urlencode 'keywords=減量' \
  --data-urlencode 'language=ja' \
  --data-urlencode 'from_timestamp=1790006400' \
  --data-urlencode 'to_timestamp=1790092799' \
  --data-urlencode 'size=1'

from_timestamp と to_timestamp はどちらも範囲に含まれるため、1 日は 00:00:00〜23:59:59 です。
total_count の表示は最大 10,000 です。1 日の件数がそれを超える場合も 10,000 と表示されます。

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

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

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

MCP を使えば、Claude や ChatGPT などの AI アシスタントにこの作業をそのまま頼めます。例：

Throk で「ダイエット」と「減量」の直近 30 日間の日本語の投稿での言及量の推移を調べて、いいね数が最も多い投稿を 5 件挙げて。

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