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

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

## 最近 30 天最常互動的人

```bash
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）](/api/mcp/#可用的工具)。