TikTok Get User Followers

2.07 credits/call
ae_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.

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
countintegerNo数量/Number20
user_idstringNo用户ID/User ID (与sec_user_id二选一/One of user_id and sec_user_id)""
min_timeintegerNo最小时间,用于翻页/Minimum time for paging0
page_tokenstringNo翻页token/Page token""
sec_user_idstringNo用户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.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.