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 が含まれ、署名の検証の方法でリクエストが 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 も引き続き使えます。詳しくは地域と言語をご覧ください。
改善：セマンティック検索の REST API で、1 回に最大 3000 件を返せるようになりました。いいね数と返信数のしきい値は、意味の照合の後に適用されるようになりました。
改善（MCP）：各ツールの説明に料金を記載しました。ラダー系のツールで地域を指定できるようになりました。

2026-07-26 · 1.4.0

新機能：GET /post/semantic-search と MCP semantic_search_posts（セマンティック検索）を追加しました。テーマを一文で説明すると、直近 30 日間で意味が最も近い投稿を見つけ、それぞれに関連度スコアを付けて返します。最初の 10 件で 30 クレジット、以降 1 件ごとに 2 クレジットです。詳しくはセマンティック検索をご覧ください。
新機能：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）をご覧ください。

2026-05-19

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