TikTok Get User Followers
Retrieve follower-list data for a specified user. Inputs: - user_id: Numeric user identifier. Use this or sec_user_id. - sec_user_id: Alphanumeric user identifier. Use this or user_id. - count: Requested number of results; defaults to 20. Keep the requested count at 20 or less. - min_time: Pagination time value; defaults to 0 for the first request. Use the value returned by the previous response to continue. - page_token: Pagination token; defaults to an empty string for the first request. Use the value returned by the previous response to continue. The response contains follower-list data. To retrieve another page, pass the returned min_time and page_token values.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
This starting charge applies to each normal successful call; it is not claimed as an absolute minimum for out-of-scope cases such as empty results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
count | integer | No | 数量/Number | 20 |
user_id | string | No | 用户ID/User ID (与sec_user_id二选一/One of user_id and sec_user_id) | "" |
min_time | integer | No | 最小时间,用于翻页/Minimum time for paging | 0 |
page_token | string | No | 翻页token/Page token | "" |
sec_user_id | string | No | 用户sec_user_id/User sec_user_id (与user_id二选一/One of user_id and sec_user_id) | "" |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_get_user_followers' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"sec_user_id": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM"
}
}'{
"code": 200,
"data": {
"extra": {
"logid": "20261104094744C7C4259FD8B4F6360036",
"now": 1793785664000
},
"followers": [
{
"accept_private_policy": false,
"apple_account": 0,
"authority_status": 0,
"avatar_168x168": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-avt-0068-euttp/a5aabff16bb56116d2ddda1eae14cb69",
"url_list": [
"https://p19-common-sign.tiktokcdn-eu.com/tos-useast2a-avt-0068-euttp/a5aabff16bb56116d2ddda1eae14cb69~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&refresh_token=280be321&x-expires=1793869200&x-signature=YAI8vyRRLcOaMYLtHkAwnHHbB3Q%3D&t=223449c4&ps=87"
],
"width": 720
},
"avatar_300x300": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-avt-0068-euttp/a5aabff16bb56116d2ddda1eae14cb69",
"url_list": [
"https://p19-common-sign.tiktokcdn-eu.com/tos-useast2a-avt-0068-euttp/a5aabff16bb56116d2ddda1eae14cb69~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&refresh_token=024dd371&x-expires=1793869200&x-signature=rW3r7UzWcR8CR0lmsH3UiQ7RATg%3D&t=223449c4&ps=87"
],
"width": 720
},
"avatar_larger": {
"data_size": 0,
"height": 720,
"uri": "tos-useast2a-avt-0068-euttp/a5aabff16bb56116d2ddda1eae14cb69",
"url_list": [
"https://p19-common-sign.tiktokcdn-eu.com/tos-useast2a-avt-0068-euttp/a5aabff16bb56116d2ddda1eae14cb69~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&refresh_token=3923e65f&x-expires=1793869200&x-signature=SRrRD9YjeW6y6TUJlA7JMNnWz70%3D&t=223449c4&ps="
],
"width": 720
}
}
]
},
"docs": "https://api.tikhub.io/#/TikTok-App-V3-API/fetch_user_follower_list_api_v1_tiktok_app_v3_fetch_user_follower_list_get",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

