Crawl Profile & Thông Tin Kênh Creator

API GET /api/tiktok/user/profile cho phép bạn lấy đầy đủ thông tin chi tiết về bất kỳ kênh/tài khoản người dùng nào trên TikTok (ảnh đại diện gốc chất lượng cao, số lượng follower, lượt thả tim tổng, số video đã đăng, tick xanh verified, TikTok Shop seller status, secUid).

---

1. Năng Lực Trích Xuất Dữ Liệu Profile

1. Avatar gốc đa độ phân giải:
   • avatarLarger: Độ phân giải cao nhất (1080x1080)
   • avatarMedium: Độ phân giải tiêu chuẩn (720x720)
   • avatarThumb: Thumbnail thu nhỏ (100x100)
2. Chỉ số Kênh Thời Gian Thực (Channel Analytics):
   • Số người theo dõi (followerCount)
   • Số tài khoản đang theo dõi (followingCount)
   • Tổng lượt thích toàn kênh (heartCount / total likes)
   • Tổng số video đã xuất bản (videoCount)
   • Số video đã thích (diggCount) và số bạn bè (friendCount)
3. Định Danh & Trạng Thái Tài Khoản:
   • TikTok User ID số (id) & unique handle (uniqueId)
   • Tên hiển thị (nickname) & Tiểu sử (signature)
   • Chuỗi định danh 64 ký tự secUid
   • Tick xanh xác minh chính chủ (verified)
   • Tài khoản người bán TikTok Shop (ttSeller)
   • Quyền riêng tư (privateAccount)

---

2. Thông số Kỹ thuật & Chi phí

• Endpoint: GET /api/tiktok/user/profile
• Chi phí Credit: 1 Credit / 1 lần gọi.
• Định dạng dữ liệu: Query Parameters.

---

3. Các tham số truy vấn (Query Parameters)

Tham số	Kiểu	Bắt buộc	Mô tả
username	String	Khuyên dùng	Username hoặc handle TikTok (vd: "lamine.yamal" hoặc "@lamine.yamal")
profileUrl	String	Tùy chọn	Đường dẫn profile (vd: https://www.tiktok.com/@lamine.yamal)
userId	String	Tùy chọn	ID số người dùng TikTok (vd: "7251849182371928374")
secUid	String	Tùy chọn	Chuỗi định danh 64 ký tự secUid của Creator
proxyUrl	String	Tùy chọn	Proxy tùy chỉnh nếu muốn cào qua IP chỉ định

Tự động nhận diện

Chỉ cần truyền username, hệ thống sẽ tự động phân giải và trích xuất dữ liệu profile ngay lập tức.

---

4. Code Mẫu Gọi API

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. Dữ liệu trả về mẫu (Response JSON)

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