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（韓文）。沒有指定時和之前一樣，回傳中文、日文與韓文串文，不含英文。計費不變（每次 30 積分，最多 10 筆）。詳見串文語言。
• 新功能：靈感庫加入英文串文：1,000 讚以上、至少 300 字元的主串文（中文、日文與韓文仍是 1,000 讚以上、超過 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 工具都改用同一個參數 language，值為 ISO 語言代碼（不分大小寫）：zh（所有中文，預設）、zh-Hant（繁體中文）、zh-Hans（簡體中文）、yue（粵語）、en（英文）、ja（日文）、ko（韓文）。排行榜、天梯與黃金時段也使用 language，每種語言分開計算；沒有「所有語言」的選項，一次查一種語言。詳見串文語言。
• 新功能：可以查詢英文串文（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 一次最多 100 個帳號，與 REST 相同。

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 一次最多 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 參數，每天除了串文數，還會回傳這些串文的讚數、回覆數、轉發數與分享數加總。開啟時每個關鍵字每天 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 一律回傳媒體網址。

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 讀取串文與帳號當下的數字，不限發文時間、不限帳號。每篇串文或每個帳號 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（爆文預測）：回傳串文目前的瀏覽數，以及達到各瀏覽數門檻的機率與預估時間。每篇 10 積分。

2026-07-29 · 1.5.0

• 新功能：新的地區值 zh、tw、hk、cn、jp、kr，適用於搜尋、熱門串文、關鍵字趨勢與 Webhook 的 language 參數，以及排行榜的 location 參數。tw 與 cn 會分辨繁體與簡體。舊的 chinese、japanese、korean 仍可使用。詳見地區與語言。
• 改進：語意搜尋的 REST API 單次最多可回傳 3000 篇；讚數與回覆數門檻在語意比對之後套用。
• 改進（MCP）：每個工具的說明都會標示價格；天梯類工具可指定地區。

2026-07-26 · 1.4.0

• 新功能：GET /post/semantic-search 與 MCP semantic_search_posts（語意搜尋）：用一句話描述主題，找出最近 30 天意思最接近的串文，每筆附相關度分數。前 10 篇 30 積分，之後每篇 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 小時。