# List TikTok user followers

Returns followers of a TikTok user, identified by `user_id` or `sec_user_id`. Maximum 20 per page; continue with the response's `min_time` and `next_page_token`.

- Platform: TikTok V2
- Request: `GET https://api.toolzerhub.com/v2/tiktok/app/user/followers`
- Auth: `x-api-key` header
- Cost: 2 credits per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/tiktok-v2/user/get-tik-tok-user-followers

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `user_id` | query | no | string | Numeric user id. Send this or sec_user_id; get either from the username resolve endpoint. |
| `sec_user_id` | query | no | string | User's sec_user_id. Send this or user_id; get either from the username resolve endpoint. |
| `count` | query | no | string | Followers per page. Use the same value on later pages; maximum 20. |
| `min_time` | query | no | string | Page one is 0. For later pages, reuse the previous response's min_time and send its next_page_token as page_token. |
| `page_token` | query | no | string | Omit for page one. For later pages, send the previous response's next_page_token with its min_time. |

## Example request

```bash
curl "https://api.toolzerhub.com/v2/tiktok/app/user/followers" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.