Throk API と MCP の更新履歴

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

2026-10-28 · 1.20.2

Webhook：キーワードルールの閲覧数（view_count）しきい値の最低値を 5,000 から 1,000 に引き下げました。人気しきい値ルールは 5,000 のままです。詳しくは Webhook をご覧ください。

2026-10-26 · 1.20.1

Webhook：閲覧数（view_count）しきい値の最低値を 20,000 から 5,000 に引き下げました。キーワードルールと人気しきい値ルールの両方に適用されます。詳しくは Webhook をご覧ください。

2026-10-09 · 1.20.0

新機能：/post/inspiration と MCP get_inspiration で language を指定できるようになりました：zh（中国語すべて：zh-Hant・zh-Hans・yue）、zh-Hant（繁体字中国語）、zh-Hans（簡体字中国語）、yue（広東語）、en（英語）、ja（日本語）、ko（韓国語）。指定しない場合はこれまでどおり、中国語・日本語・韓国語の投稿から選ばれ、英語は含まれません。料金は変わりません（1 回 30 クレジット、最大 10 件）。詳しくは投稿の言語をご覧ください。
新機能：インスピレーションの対象に英語の投稿が加わりました：いいね 1,000 以上で 300 文字以上のメイン投稿です（中国語・日本語・韓国語は引き続き、いいね 1,000 以上で CJK 文字が 200 文字を超える投稿）。英語の投稿は 2026-10-09 から収録しており、それ以前の英語の投稿は順次追加しています。

2026-10-09 · 1.19.0

新機能：セマンティック検索が英語の投稿に対応しました。/post/semantic-search と MCP semantic_search_posts で language=en を指定でき、使い方と料金はほかの言語と同じです。英語の投稿のセマンティックデータはこの更新から蓄積が始まるため、最初の数週間は検索できる期間が 30 日より短くなります。/post/inspiration（get_inspiration）には引き続き英語の投稿は含まれません。

2026-10-09 · 1.18.0

変更：投稿を絞り込むすべてのエンドポイントと MCP ツールが、1 つのパラメータ language に統一されました。値は ISO の言語コード（大文字・小文字を区別しない）で、zh（すべての中国語。デフォルト）、zh-Hant（繁体字中国語）、zh-Hans（簡体字中国語）、yue（広東語）、en（英語）、ja（日本語）、ko（韓国語）です。ランキング、ラダー、ゴールデンタイムも language を使い、言語ごとに別々に集計されます。「すべての言語」の選択肢はなく、1 回の呼び出しで 1 言語を照会します。詳しくは投稿の言語をご覧ください。
新機能：英語の投稿（language=en）を、キーワード検索、キーワードトレンド、人気投稿、ランキング、ラダー、ゴールデンタイムで照会できるようになりました。英語の投稿では、単数形・複数形などの語形変化もまとめて照合されます。詳しくは検索ルールをご覧ください。セマンティック検索は現在、英語に対応していません（400 が返されます）。
新機能：/leaderboard/follower-growth と MCP の get_follower_growth で language を指定できるようになりました（7 つすべてに対応）。
Webhook：ルールの language には zh（デフォルト）、zh-Hant、zh-Hans、yue、ja、ko を指定でき、レスポンスでも常にこれらのコードが使われます。

2026-10-02 · 1.17.0

新機能：開発者プラットフォームで API キーの名前の変更やローテーション（同じ名前で新しいキーを発行し、古いキーは直ちに無効）ができるようになり、最終使用日も表示されます。有効なキーはアカウントごとに最大 20 個です。
改善：/post/inspiration と MCP get_inspiration は、毎日更新される高エンゲージメント投稿（いいね 1,000 以上）から探すようになりました。日本語や韓国語の投稿が含まれることがあります。

2026-09-30 · 1.11.2

変更：/user/{username}/interactions と MCP get_user_interactions のデフォルトを 10 アカウント（以前は 20）に変更し、10 アカウントまで 30 クレジット、1 アカウント増えるごとに 2 クレジット追加としました（以前は 30 アカウントまで 70 クレジット）。やり取りがなければ引き続き無料です。MCP も REST と同じく 1 回あたり最大 100 アカウントです。

2026-09-30 · 1.11.0

新機能：GET /user/{username}/interactions と MCP get_user_interactions（交流ランキング）を追加しました。直近 7〜90 日間にアカウントが最もよくリプライし合っている相手を、双方のリプライ回数と最後のやり取りの時刻付きで返します。双方向のやり取り、合計、送ったリプライ、受け取ったリプライで並べ替えられます。30 アカウントで 70 クレジット、1 アカウント増えるごとに 2 クレジット追加、やり取りがなければ無料です。詳しくは交流ランキングをご覧ください。

2026-09-25 · 1.10.0

新機能：MCP に Throk アカウントでログイン（OAuth）して接続できるようになりました。Claude、ChatGPT、Codex、Cursor に対応しています。API キーは不要で、引き続きアカウントの API クレジットを使います。設定方法はAI アシスタントで使う（MCP）をご覧ください。
変更：クレジット使用履歴の「キー」列が「ソース」になり、Throk アカウントでログインした AI ツールは「アカウントログイン · アプリ名」と表示されます。

2026-09-24 · 1.9.2

変更：/post/search で期間を指定しない場合、直近 7 日を検索します（従来は 3 時間）。どの期間指定でも遡れるのは最大 90 日です。
変更：クレジット不足のときは HTTP 402 を返します（従来は 400）。
変更：パラメータのエラー（矛盾する期間指定を含む）は常に HTTP 400、形式は {"detail": "エラーメッセージ"} です（従来は一部が 422）。
変更：/post/forecast は 1 回に最大 20 件の投稿までです。
改善：キーワードトレンドが tw と cn に対応しました。
改善：post_type=thread は include_details なしで使えます。
Webhook：イベントに rule フィールドを追加。エンドポイントを作成するとすぐにテストできます。キーワードルールでは lookbackHours を指定できません。ルールの language は送信した表記のまま返り、フィールド名はスネークケース（例：like_count）も使えます。

2026-09-23 · 1.9.1

改善：Webhook イベントの X-Throk-Signature ヘッダーに v1 署名が付き、Throk から送られたイベントであることを検証できます。

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 で長い期間を照会する際の速度が大幅に向上しました。
変更：バックエンドが一時的に利用できない場合は HTTP 503 を返します。しばらくしてから再試行してください。

2026-08-21 · 1.6.1 / 1.6.2

変更：人気投稿、投稿のリプライチェーン、セマンティック検索、ランキング、アカウントの投稿の post_timestamp を UTC の Unix 時間（秒）に統一し、ほかのエンドポイントと揃えました。
改善：バズ予測がカンマ区切りの複数の投稿コードを受け付けるようになり、エラーメッセージもわかりやすくなりました。予測対象期間外の投稿は課金されません。

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 の language パラメータと、ランキングの location パラメータで使えます。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）。
改善（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 時間で設定できます。