TikTok Profile

Fetches public profile data for a TikTok user by their handle — useful for looking up a creator's identity, bio, and account stats.

1 credit / request

Open Playground

GET /v1/tiktok/profile Try it

TikTok Profile
GET /v1/tiktok/profile

Fetches public profile data for a TikTok user by their handle — useful for looking up a creator's identity, bio, and account stats.

Authentication: x-api-key
Example URL: https://api.datawake.ai/v1/tiktok/profile?handle=stoolpresidente

Parameters:
- handle (query · string · required) = stoolpresidente

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.

Fetches public profile data for a TikTok user by their handle — useful for looking up a creator's identity, bio, and account stats. Returns a `user` object (display name, avatar URLs, bio/signature, verification status, bio link) and a `stats` object (followerCount, followingCount, heartCount/total likes, videoCount). This only returns profile metadata, not the user's actual videos or followers list.

Required params: handle.

Headers

x-api-key string required

Your Wake API access key.

Example:

YOUR_API_KEY

Query Parameters

handle string required

TikTok handle

Example:

stoolpresidente


              curl 'https://api.datawake.ai/v1/tiktok/profile?handle=stoolpresidente' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/tiktok/profile?handle=stoolpresidente", {
  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/profile?handle=stoolpresidente",
    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/profile?handle=stoolpresidente",
    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/profile?handle=stoolpresidente", 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/profile?handle=stoolpresidente"))
    .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());


              {
  "user": {
    "id": "6659752019493208069",
    "shortId": "",
    "uniqueId": "stoolpresidente",
    "nickname": "Dave Portnoy",
    "avatarLarger": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~c5_1080x1080.jpeg?lk3s=a5d48078&nonce=58494&refresh_token=466ff0b92ed2f51170dbbdc2a30b9e9a&x-expires=17379...",
    "avatarMedium": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~c5_720x720.jpeg?lk3s=a5d48078&nonce=18587&refresh_token=4c5e30ff3fe99ca813d9f79d74c41fb1&x-expires=1737921...",
    "avatarThumb": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~c5_100x100.jpeg?lk3s=a5d48078&nonce=56685&refresh_token=52483b418cbeceeaf2863a9fe0feb830&x-expires=1737921...",
    "signature": "El Presidente/Barstool Sports Founder.",
    "createTime": 1550594547,
    "verified": true,
    "secUid": "MS4wLjABAAAAINC_ElRR-l1RCcnEjOZhNO-9wOzAMf-YHXqRY8vvG9bEhMRa6iu23TaE3JPZYXBD",
    "ftc": false,
    "relation": 0,
    "openFavorite": false,
    "bioLink": {
      "link": "https://www.barstoolsports.com/bios/Surviving-Barstool",
      "risk": 0
    },
    "commentSetting": 0,
    "commerceUserInfo": {
      "commerceUser": false
    },
    "duetSetting": 0,
    "...": "20 more fields"
  },
  "stats": {
    "followerCount": 4100000,
    "followingCount": 74,
    "heart": 190400000,
    "heartCount": 190400000,
    "videoCount": 2017,
    "diggCount": 0,
    "friendCount": 52
  },
  "itemList": []
}


              {
  "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."
  }
}