# 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 |

## 응답

계정마다 1건씩, `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)](/ko/api/mcp/#사용-가능한-도구)를 참고하세요.