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/月起，依每月積分選方案。
四個方案都能用全部資料端點與 MCP，Standard 以上再加 Webhook。Throk MCP 與 REST API 共用同一套開發者積分。
可以回答什麼
你的 AI Agent 可以拿 Throk 回答什麼？
先從要做的決定出發，再選需要的 Threads 資料。工具名稱與查詢限制放在技術資料裡。
- 01
找題材與需求
搜尋貼文、語意相近內容與關鍵字聲量。
- 02
看競品與帳號
查看近期內容、熱門貼文與粉絲變化。
- 03
抓趨勢與時機
查看熱門排行、成長排行與發文時段。
查看 19 個工具與查詢限制＋
完整工具列表
十九個工具，一組金鑰
從關鍵字與語意搜尋、熱門與爆紅排行、神回覆與粉絲增長，到黃金時間熱圖、粉絲與讚數天梯，再到帳號資料、最常互動的人、粉絲歷史、即時數據與爆文預測，一次到位。
| 工具 | 回傳 | 上限 |
|---|---|---|
| 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 天 |
| get_user_interactions | 帳號最常互動的人 | 最多 100 個、90 天 |
| forecast_posts | 爆文預測：48 小時瀏覽量與里程碑機率 | 10 篇 / 次，發文 1–12 小時 |
| get_live_posts | 即時貼文數據與圖片 | 10 篇 / 次 |
| get_live_users | 即時帳號粉絲數與檔案 | 10 位 / 次 |
| get_balance | 查詢剩餘積分 | 免費 |
可以做出什麼
接上之後，可以做出這些
每一個都只用現有的工具與端點。
品牌聲量看板
每天用 get_keyword_trend 拉品牌詞的聲量，串文一過門檻就用 Webhook 推給團隊。
每週競品報告
用排程或 n8n 定期呼叫 get_user 與粉絲歷史，自動整理成週報。
KOL 篩選
用粉絲天梯看出帳號在平台上的位置，再用最常互動的人看出它的圈子。
AI 寫手
在 Claude 裡先查熱門串文與神回覆，再讓它依數據起草。
常見問題
- API 的積分跟 Throk 訂閱方案一樣嗎？
- 不一樣。開發者平台有獨立的 API 方案與積分，與網頁版的 Free／Creator／Creator+ 訂閱完全分開、不可互通，需在開發者主控台另行訂閱。
- Throk API 和 Meta 官方的 Threads API 有什麼不同？
- Meta 官方的 Threads API 用來發佈串文、管理你自己的帳號，需要通過 Meta 的應用程式審查。Throk API 用來查詢 Threads 上的公開數據：搜尋串文、關鍵字趨勢、熱門排行，以及任何公開帳號的粉絲走勢。兩者用途不同，也可以一起使用。
- 有免費額度嗎？怎麼收費？
- 方案依每月積分計價，從 API Lite（15,000 積分／月）到 Premium（6,000,000 積分／月），在開發者平台選購。查詢餘額、消費紀錄與 Webhook 測試事件都不扣積分。
- 積分多久到期？
- 積分自購買日起一個月內有效，未用完不累計到下一期。需要更多額度時，可升級方案，或依方案費率一次性加購積分（API Standard US$10、Plus US$5、Premium US$4／每 10,000 積分），加購額度於本期帳單週期結束時重置。
- 該用 MCP 還是 REST？支援哪些客戶端？
- 要讓 AI Agent 使用就用 MCP，支援 Claude、ChatGPT、Codex、Cursor 等客戶端，一行指令接上；想在自己的服務裡直接呼叫就用 REST。所有功能兩邊都涵蓋。
- 資料涵蓋哪些範圍？
- 涵蓋 Threads 公開串文的關鍵字搜尋、熱門排行、關鍵字趨勢、帳號資料與粉絲歷史。串文依本身的語言分類，不看作者所在地；每次呼叫用 language 參數指定一種語言：zh（中文（全部））、zh-Hant（繁體中文）、zh-Hans（簡體中文）、yue（粵語）、en（英文）、ja（日文）、ko（韓文）。未指定時預設為 zh，要查英文、日文或韓文串文請明確指定；要比較多種語言請分次呼叫。所有搜尋、趨勢、排行與天梯端點都支援這 7 種語言；Webhook 規則支援中文、日文與韓文串文。
- 怎麼開始？
- 到 developer.throk.ai 註冊、建立 API 金鑰，選擇方案後即可開始呼叫。MCP 也可以不用金鑰，直接用 Throk 帳號登入。