跳到內容

用 Throk API 找出帳號最常互動的人

GET /user/{username}/interactions 回傳一個帳號在一段時間內,跟哪些帳號互相回覆最多:他回覆了誰幾次、誰回覆了他幾次。適合找出創作者的核心圈子,或看兩個帳號之間的互動有多密切。

終端機視窗
curl -G 'https://premium-api.throk.ai/user/throk.ai/interactions' \
-H 'Authorization: Bearer sk-throk-...' \
--data-urlencode 'days=30' \
--data-urlencode 'size=20'
參數 說明 預設
days 回溯天數,7–90 30
sort mutual(雙向互動優先)、total(兩個方向合計)、replies_sent(他最常回覆的人)、replies_received(最常回覆他的人) mutual
size 回傳帳號數,1–100 10
min_replies 兩個方向合計至少幾則回覆才列入 2

每個帳號一筆,依 sort 由高到低排列:

欄位 說明
rank 名次
user 對方帳號(用戶名稱、顯示名稱、頭像、粉絲數)
replies_sent 查詢的帳號回覆對方的次數
replies_received 對方回覆查詢帳號的次數
total 兩個方向合計
mutual 兩個方向中較小的一邊,雙方都有來往時才大於 0
last_interaction 最近一次互相回覆的時間(UNIX 秒)

metadata.total_count 是期間內達到 min_replies 的帳號總數,user 是查詢的帳號本身。

  • 只計算回覆:按讚、轉發、引用和標註都不算。
  • 只計算 Throk 收錄到的回覆,不是帳號的全部回覆,所以適合看排名和相對強弱,不適合當作精確總數。中文、日文、韓文帳號之間的互動收錄得最完整。
  • 自己回覆自己的串文(接續串文)不算互動。
  • 會自動回覆所有標註者的 @meta.ai 不列入。
  • 新的回覆被收錄後就會計入,不需要等每日更新。

10 個帳號以內 30 積分,每多 1 個加 2 積分(例如回傳 50 個為 110 積分),依實際回傳的帳號數計費,不足 10 個也是 30 積分;沒有任何互動時不收費。查無此帳號回傳 404,也不收費。

MCP 工具 get_user_interactions 提供相同的功能,一次最多 100 個帳號,價格相同。詳見在 AI 助手中使用(MCP)。