Crawl Creator Profile & Channel Analytics

The GET /api/tiktok/user/profile endpoint retrieves complete profile metrics and creator details for any TikTok user account (high-res avatars, follower count, total likes, video count, verified tick, TikTok Shop seller status, and secUid).

---

1. Capabilities

1. Multi-resolution Avatars:
   • avatarLarger: High definition (1080x1080)
   • avatarMedium: Standard definition (720x720)
   • avatarThumb: Small thumbnail (100x100)
2. Real-time Channel Metrics:
   • Follower count (followerCount)
   • Following count (followingCount)
   • Total account likes (heartCount)
   • Total published videos (videoCount)
   • Liked video count (diggCount) and friend count (friendCount)
3. Identity & Creator Status:
   • Numeric User ID (id) and unique handle (uniqueId)
   • Display name (nickname) and Bio (signature)
   • 64-character secUid
   • Verification tick (verified)
   • TikTok Shop seller account (ttSeller)
   • Privacy setting (privateAccount)

---

2. Technical Specifications & Pricing

• Endpoint: GET /api/tiktok/user/profile
• Credit Cost: 1 Credit per request.
• Input Format: Query Parameters.

---

3. Query Parameters

Parameter	Type	Required	Description
username	String	Recommended	TikTok username or handle (e.g. "lamine.yamal" or "@lamine.yamal")
profileUrl	String	Optional	Profile URL or short link (e.g. https://www.tiktok.com/@lamine.yamal)
userId	String	Optional	Numeric user ID (e.g. "7251849182371928374")
secUid	String	Optional	64-character creator secUid
proxyUrl	String	Optional	Custom proxy URL (e.g. http://proxy.example.com:8080)

---

4. Code Examples

cURL

curl -X GET "https://api.stackvid.dev/api/tiktok/user/profile?username=lamine.yamal" \
  -H "X-API-Key: tk_live_YOUR_API_KEY"

Node.js (Axios)

import axios from 'axios';

async function getCreatorProfile(username: string) {
  const response = await axios.get('https://api.stackvid.dev/api/tiktok/user/profile', {
    params: { username },
    headers: {
      'X-API-Key': 'tk_live_YOUR_API_KEY',
    },
  });

  console.log('Creator Profile:', response.data.user);
  return response.data;
}

Python (requests)

import requests

def get_creator_profile(username: str):
    url = "https://api.stackvid.dev/api/tiktok/user/profile"
    headers = {"X-API-Key": "tk_live_YOUR_API_KEY"}
    params = {"username": username}

    resp = requests.get(url, headers=headers, params=params)
    data = resp.json()
    print("Nickname:", data["user"]["nickname"])
    print("Followers:", data["user"]["followerCount"])
    return data

---

5. Sample Response (200 OK)

{
  "success": true,
  "user": {
    "id": "7251849182371928374",
    "uniqueId": "lamine.yamal",
    "nickname": "Lamine Yamal",
    "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/77bb53f891028f660af4c375e534d60c~tplv-tiktokx-cropcenter:100:100.jpeg?...",
    "avatarMedium": "https://p19-common-sign.tiktokcdn.com/tos-alisg-avt-0068/77bb53f891028f660af4c375e534d60c~tplv-tiktokx-cropcenter:720:720.jpeg?...",
    "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/77bb53f891028f660af4c375e534d60c~tplv-tiktokx-cropcenter:1080:1080.jpeg?...",
    "signature": "FC Barcelona & Spain 🇪🇸⚽️",
    "verified": true,
    "secUid": "MS4wLjABAAAAN8lpi9aJjiPSF_8CrejiLzUvsPfS-vhZ1V6KHGxgAe67kK1og6cyET8dq-LkgKdc",
    "privateAccount": false,
    "ttSeller": false,
    "followingVisibility": 1,
    "followerCount": 25400000,
    "followingCount": 42,
    "heartCount": 280500000,
    "videoCount": 58,
    "diggCount": 0,
    "friendCount": 0
  }
}