AGENT 實況
Agent 怎麼用這些數據？
丟一個真實問題，看 Agent 自己呼叫工具、讀回數據，再給出有根據的建議。下面是一次完整的對話。
mcp · throk
「換工作」這個題材最近還有紅利嗎？
⚙ get_hot_posts⚙ get_keyword_trend⚙ search_posts
還在升溫。「換工作」近 7 天的貼文量成長 3.1 倍，而且尚未出現破 5 萬讚的天花板文：
6/07
6/09
6/11
6/13
建議切角：別寫「我離職了」，寫「留下來的人怎麼想」。高互動回覆裡有 38% 來自還沒離職的觀望者，這群人在找代言人。
接入方式
MCP 或 REST
給 Agent 用 MCP，給服務用 REST。
02 · REST API
REST API
或直接打 REST
THREADS API 價格
US$30/月起，依每月積分選方案。
四個方案都開放全部 API 端點。Throk MCP 與 REST API 共用同一套開發者積分。
可以回答什麼
你的 AI Agent 可以拿 Throk 回答什麼？
先從要做的決定出發，再選需要的 Threads 資料。工具名稱與查詢限制放在技術資料裡。
- 01
找題材與需求
搜尋貼文、語意相近內容與關鍵字聲量。
- 02
看競品與帳號
查看近期內容、熱門貼文與粉絲變化。
- 03
抓趨勢與時機
查看熱門排行、成長排行與發文時段。
查看 18 個工具與查詢限制＋
完整工具列表
十八個工具，一組金鑰
從關鍵字與語意搜尋、熱門與爆紅排行、神回覆與粉絲增長，到黃金時間熱圖、粉絲與讚數天梯，再到用戶檔案、粉絲歷史、即時數據與爆文預測，一次到位。
| 工具 | 回傳 | 上限 |
|---|---|---|
| search_posts | 關鍵字搜尋公開貼文 | 25 筆 / 次 |
| get_inspiration | 靈感語意搜尋高互動貼文 | 10 筆 |
| semantic_search_posts | 語意搜尋近 30 天貼文 | 10 筆 |
| get_hot_posts | 熱門貼文排行 | 50 筆 |
| get_keyword_trend | 關鍵字每日聲量 | 10 字 × 90 天 |
| get_post_like_growth | 爆紅串文排行 | 50 筆 |
| get_cool_replies | 神回覆排行 | 50 筆 |
| get_follower_growth | 粉絲增長排行 | 50 筆 |
| get_power_hours | 平台黃金時間熱圖 | 近 28 天 |
| get_follower_ladder | 粉絲數天梯 | 百分位 |
| get_like_ladder | 讚好數天梯 | 近 24 小時 |
| get_user | 用戶檔案與近期貼文 | 各 25 筆 |
| get_user_top_threads | 用戶讚數最高的貼文 | 最長 720 天 |
| get_user_follower_history | 粉絲數歷史 | 最長 365 天 |
| forecast_posts | 爆文預測：48 小時瀏覽量與里程碑機率 | 10 篇 / 次，發文 1–12 小時 |
| get_live_posts | 即時貼文數據與圖片 | 10 篇 / 次 |
| get_live_users | 即時帳號粉絲數與檔案 | 10 位 / 次 |
| get_balance | 查詢剩餘積分 | 免費 |
常見問題
- API 的積分跟 Throk 訂閱方案一樣嗎？
- 不一樣。開發者平台有獨立的 API 方案與積分，與網頁版的 Free／Creator／Creator+ 訂閱完全分開、不可互通，需在開發者主控台另行訂閱。
- 有免費額度嗎？怎麼收費？
- API 存取沒有免費額度。方案依每月積分額度區分，從 API Lite（15,000 積分／月）到 Premium（6,000,000 積分／月），可在開發者主控台選購。
- 積分多久到期？
- 積分自購買日起一個月內有效，未用完不累計到下一期。需要更多額度時，可升級方案，或依方案費率一次性加購積分（API Standard US$10、Plus US$5、Premium US$4／每 10,000 積分），加購額度於本期帳單週期結束時重置。
- 該用 MCP 還是 REST？支援哪些客戶端？
- 要讓 AI Agent 使用就用 MCP，支援 Claude、ChatGPT、Codex、Cursor 等客戶端，一行指令接上；想在自己的服務裡直接呼叫就用 REST。所有功能兩邊都涵蓋。
- 資料涵蓋哪些範圍？
- 涵蓋 Threads 公開貼文的關鍵字搜尋、熱門排行、關鍵字趨勢、用戶檔案與粉絲歷史，並依地區支援繁體中文、日文與韓文市場。
- 怎麼開始？
- 到 developer.throk.ai 註冊、建立 API 金鑰，選擇方案後即可開始呼叫。MCP 也可以不用金鑰，直接用 Throk 帳號登入。