TikTok Followers

Retrieves the follower list of a TikTok account by handle or user_id — useful for seeing who follows a creator or getting subscriber data.

1 credit / request

Open Playground

GET /v1/tiktok/user/followers Try it

TikTok Followers
GET /v1/tiktok/user/followers

Retrieves the follower list of a TikTok account by handle or user_id — useful for seeing who follows a creator or getting subscriber data.

Authentication: x-api-key
Example URL: https://api.datawake.ai/v1/tiktok/user/followers?handle=stoolpresidente&user_id=6659752019493208069&min_time=1605663376

Parameters:
- handle (query · string · optional) = stoolpresidente
- user_id (query · string · optional) = 6659752019493208069
- min_time (query · number · optional) = 1605663376
- trim (query · boolean · optional)

Overview

WakeScrap exposes this TikTok endpoint as a live-data API. The platform keeps the documented request and response shape stable while unifying auth, request tracking, and credits billing.

Retrieves the follower list of a TikTok account by handle or user_id — useful for seeing who follows a creator or getting subscriber data. Returns `followers`, an array of user objects each with `nickname`, `unique_id`, `uid`, `follower_count`, `following_count`, and avatar URLs; also returns `total` follower count. Paginate with `min_time` from the previous response.

Optional query parameters can be combined in a single request.

Headers

x-api-key string required

Your Wake API access key.

Example:

YOUR_API_KEY

Query Parameters

handle string

TikTok handle

Example:

stoolpresidente

user_id string

User id. Use this for faster response times.

Example:

6659752019493208069

min_time number

Used to paginate. Get 'min_time' from previous response.

Example:

1605663376

trim boolean

Set to true to get a trimmed response


              curl 'https://api.datawake.ai/v1/tiktok/user/followers?handle=stoolpresidente&user_id=6659752019493208069&min_time=1605663376' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/tiktok/user/followers?handle=stoolpresidente&user_id=6659752019493208069&min_time=1605663376", {
  method: "GET",
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
console.log(data);


              import requests

response = requests.request(
    "GET",
    "https://api.datawake.ai/v1/tiktok/user/followers?handle=stoolpresidente&user_id=6659752019493208069&min_time=1605663376",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json",
    },
)

print(response.json())


              $ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.datawake.ai/v1/tiktok/user/followers?handle=stoolpresidente&user_id=6659752019493208069&min_time=1605663376",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        'x-api-key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;


              client := &http.Client{}
req, err := http.NewRequest("GET", "https://api.datawake.ai/v1/tiktok/user/followers?handle=stoolpresidente&user_id=6659752019493208069&min_time=1605663376", nil)
if err != nil {
    panic(err)
}

req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Accept", "application/json")

resp, err := client.Do(req)
if err != nil {
    panic(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))


              HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.datawake.ai/v1/tiktok/user/followers?handle=stoolpresidente&user_id=6659752019493208069&min_time=1605663376"))
    .header("x-api-key", "YOUR_API_KEY")
    .header("Accept", "application/json")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());


              {
  "followers": [
    {
      "create_time": 1585489718,
      "follower_count": 319,
      "following_count": 1375,
      "language": "en",
      "nickname": "Kelsey Levens Haskin",
      "region": "US",
      "sec_uid": "MS4wLjABAAAAG-DXjA9PmiU6daPQzr9ux9Xr8EQ_SU_STIlWxqs2huXTZR94IdbY2kpoGhiSzAxn",
      "signature": "",
      "uid": "6802639142851609605",
      "unique_id": "klh723",
      "avatar_medium": {
        "height": 720,
        "uri": "tos-maliva-avt-0068/7324817662562402310",
        "url_list": [
          "..."
        ],
        "url_prefix": null,
        "width": 720
      }
    }
  ],
  "min_time": 1750289478,
  "total": 4424847
}


              {
  "error": {
    "code": "invalid_request",
    "message": "One or more required parameters are missing or invalid."
  }
}


              {
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing x-api-key header."
  }
}


              {
  "error": {
    "code": "insufficient_credits",
    "message": "This request requires available credits before execution."
  }
}