Throk API 與 MCP 更新紀錄

Throk API（premium-api.throk.ai）與 MCP 工具的更新紀錄，最新的在最上面。標示 MCP 的項目也適用於對應的 MCP 工具。

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 查詢長時間範圍時大幅加快。
• 修正：不再出現「回傳空結果卻扣了積分」的情況；後端暫時無法服務時會回傳 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（爆文預測）：回傳串文目前的瀏覽數，以及達到各瀏覽數門檻的機率與預估時間。每篇 10 積分。

2026-07-29 · 1.5.0

• 新功能：新的地區值 zh、tw、hk、cn、jp、kr，適用於搜尋、熱門串文、關鍵字趨勢、排行榜與 Webhook。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）。
• 修正：熱門串文依瀏覽數排序時，搭配香港或語言篩選的問題（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 小時。