# Throk API と MCP の更新履歴

Throk API（`premium-api.throk.ai`）と MCP ツールの更新履歴です。新しいものが上にあります。**MCP** と記載された項目は、対応する MCP ツールにも適用されます。

## 2026-09-23 · 1.9.1

- **修正**：人気投稿（`/post/hot`、MCP `get_hot_posts`）で結果がない場合、クレジットを消費しないようにしました。
- **修正**：`/post/search` の `total_pages` を切り上げで計算するようにしました。最後のページが 1 ページ分に満たなくても総ページ数に含まれます。
- **修正**：Webhook イベントに署名が付くようになりました。`X-Throk-Signature` ヘッダーに `v1` が含まれ、[署名の検証](/ja/api/webhooks/#署名の検証) の方法でリクエストが Throk からのものか確認できます。以前のイベントにはタイムスタンプ `t` しかありませんでした。
- **修正**：閲覧数のしきい値だけを設定した人気しきい値の Webhook ルールが発火していなかった問題を修正しました。地域を `tw` または `cn` にした場合も使えます。
- **補足**：Webhook はイベントを 1 件送信するごとに 20 クレジットを消費します。受信側の応答の成否にかかわらず、送信時点で課金されます。

## 2026-09-22 · 1.9.0

- **新機能**：キーワードトレンド（`/post/keyword-trend`、MCP `get_keyword_trend`）に `include_engagement` パラメータを追加しました。日ごとの投稿数に加えて、それらの投稿のいいね数、返信数、リポスト数、シェア数の合計も返します。有効にした場合は 1 キーワード 1 日あたり 4 クレジット（従来は 3 クレジット）です。有効にしない場合、レスポンスと課金はこれまでと同じです。
- **改善**：アカウントを大量に一括照会しても、他のリアルタイム照会が遅くならないようにしました。

## 2026-09-17 · 1.8.3

- **新機能**：`/post/search` と MCP `search_posts` に `min_age_hours`、`max_age_hours` を追加しました。「投稿から何時間後か」で検索範囲を直接指定できます（最長 90 日）。
- **改善**：`/post/{code}/chain` がリアルタイムで取得した返信をマージするようになり、まだ収録されていない投稿も照会できるようになりました。
- **改善**：`/user` とアカウントの一括照会で、データが不足している場合はリアルタイムのアカウントデータを使うようになりました。

## 2026-09-17 · 1.8.2

- **改善**：`/live/posts` のレスポンスに `media_url` と `reshare_count` を追加しました。MCP `get_live_posts` は常にメディアの URL を返します。

## 2026-09-10 · 1.8.1

- **改善**：バズ予測（`/post/forecast`、MCP `forecast_posts`）で、投稿から **1 時間**後に予測できるようになりました（従来は 2 時間）。あわせて予測モデルを更新しました。投稿から 1〜2 時間の投稿も課金対象になりました。

## 2026-08-29 · 1.8.0

- **新機能**：`GET /live/posts`、`GET /live/users` と MCP `get_live_posts`、`get_live_users` を追加しました。Threads から投稿とアカウントの**現時点**の数値をリアルタイムで取得します。投稿時期やアカウントを問いません。投稿 1 件またはアカウント 1 件につき 3 クレジット、Threads が閲覧数を非表示にしている場合は 1 クレジットで、取得に失敗した場合は課金されません。

## 2026-08-25 · 1.7.1

- **改善**：`/user/{username}/top-threads` で長い期間を照会する際の速度が大幅に向上しました。
- **修正**：「空の結果が返ったのにクレジットが消費される」問題を修正しました。バックエンドが一時的に利用できない場合は 503 を返します。

## 2026-08-21 · 1.6.1 / 1.6.2

- **修正**：人気投稿、投稿の返信チェーン、セマンティック検索、ランキング、アカウントの投稿で、`post_timestamp` が実際より 8 時間早くなっていた問題を修正しました。
- **改善**：バズ予測がカンマ区切りの複数の投稿コードを受け付けるようになり、エラーメッセージもわかりやすくなりました。予測対象期間外の投稿は課金されません。
- **修正**：Webhook のテストイベントのエンドポイントが 500 を返す問題を修正しました。

## 2026-08-18 · 1.6.0

- **新機能**：`GET /post/forecast` と MCP `forecast_posts`（バズ予測）を追加しました。投稿の現在の閲覧数と、閲覧数の各基準に達する確率と予想時刻を返します。1 件につき 10 クレジットです。

## 2026-07-29 · 1.5.0

- **新機能**：新しい地域の値 `zh`、`tw`、`hk`、`cn`、`jp`、`kr` を追加しました。検索、人気投稿、キーワードトレンド、ランキング、Webhook で使えます。`tw` と `cn` は繁体字と簡体字を区別します。従来の `chinese`、`japanese`、`korean` も引き続き使えます。詳しくは[地域と言語](/ja/api/guides/regions/)をご覧ください。
- **改善**：セマンティック検索の REST API で、1 回に最大 3000 件を返せるようになりました。いいね数と返信数のしきい値は、意味の照合の後に適用されるようになりました。
- **改善（MCP）**：各ツールの説明に料金を記載しました。ラダー系のツールで地域を指定できるようになりました。

## 2026-07-26 · 1.4.0

- **新機能**：`GET /post/semantic-search` と MCP `semantic_search_posts`（セマンティック検索）を追加しました。テーマを一文で説明すると、直近 30 日間で意味が最も近い投稿を見つけ、それぞれに関連度スコアを付けて返します。最初の 10 件で 30 クレジット、以降 1 件ごとに 2 クレジットです。詳しくは[セマンティック検索](/ja/api/semantic-search/)をご覧ください。
- **新機能**：Webhook のルールで閲覧数（`view_count`）のしきい値を設定できるようになりました（07-23）。
- **新機能**：Webhook のルールで言語または市場による絞り込みができるようになりました（07-15）。
- **改善**：人気投稿、投稿の返信チェーン、詳細データ付きの検索、アカウント照会、アカウントの人気投稿で、閲覧数 `impression_count` を返すようになりました（07-13）。
- **修正**：人気投稿を閲覧数順に並べる際に、香港または言語の絞り込みと組み合わせると発生していた問題を修正しました（07-15）。
- **改善（MCP）**：ツールの呼び出しが 60 秒を超えた場合、止まったままにならず、説明メッセージを返すようになりました（07-11）。

## 2026-06-29

- **変更**：Webhook の作成には API Standard 以上のプランが必要になりました。
- **変更**：Webhook のルールに、いいね数と返信数の最低しきい値を設けました。

## 2026-06-19 · 1.2.0

- **新機能**：検索、人気投稿、キーワードトレンドに `language` パラメータ（`chinese`、`hk`、`japanese`、`korean`）を追加しました。

## 2026-06-16 · 1.2.0

- **新機能**：REST のランキングとデータのエンドポイントを追加しました：`/leaderboard/cool-replies`（神返信）、`/leaderboard/post-like-growth`（バズ投稿）、`/leaderboard/follower-growth`（フォロワー増加）、`/stats/follower-ladder`、`/stats/like-ladder`、`/stats/power-hours`、`/post/inspiration`（インスピレーション検索）。

## 2026-06-15 · 1.1.0

- **新機能（MCP）**：ツール `get_cool_replies`、`get_post_like_growth`、`get_follower_growth`、`get_follower_ladder`、`get_like_ladder`、`get_power_hours`、`get_inspiration` を追加しました。

## 2026-06-10 · 1.0.0

- **新機能（MCP）**：MCP サーバー `https://premium-api.throk.ai/mcp` をリリースしました。REST API と同じキーと料金で使えます。最初に提供したツール：`search_posts`、`get_hot_posts`、`get_keyword_trend`、`get_user`、`get_user_top_threads`、`get_user_follower_history`、`get_balance`。設定方法は[AI アシスタントで使う（MCP）](/ja/api/mcp/)をご覧ください。

## 2026-05-19

- **新機能**：Webhook の「人気」ルール：キーワードを空欄にでき、遡る時間を 1〜72 時間で設定できます。