Crawl Posts Của Creator & Phân Tích Video

API GET /api/tiktok/user/posts cho phép bạn cào toàn bộ danh sách bài viết/video được xuất bản bởi bất kỳ nhà sáng tạo nội dung (Creator) nào trên TikTok, bao gồm link tải MP4 sạch không logo và thông tin giỏ hàng sản phẩm TikTok Shop.

---

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

1. Lấy link Tải Video sạch không Watermark (downloadNoWatermarkUrl): Đường dẫn tải trực tiếp video MP4 nguyên bản không logo phục vụ re-up, biên tập hoặc lưu trữ.
2. Thông tin Kỹ thuật & Luồng Bitrate (video): Kích thước (width, height), định dạng, dung lượng byte và danh sách luồng phát đa độ phân giải (bitrates) lên tới 1080p60.
3. Bóc tách Sản phẩm Giỏ Hàng TikTok Shop (products): Tự động phân giải các thẻ sản phẩm Showcase gắn kèm trong bài viết (Mã sản phẩm productId, tiêu đề sản phẩm, từ khóa hiển thị, ảnh bìa sản phẩm).
4. Thông tin Âm Thanh Bản Quyền (music): ID bài hát, tên giai điệu, thời lượng, và cờ kiểm tra bản quyền thương mại (isCommerceMusic).
5. Cơ chế Phân Trang (cursor, hasMore): Quét hàng trăm bài viết xuyên suốt lịch sử của kênh qua tham số con trỏ cursor.

---

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

• Endpoint: GET /api/tiktok/user/posts
• Chi phí Credit: 1 Credit / 1 lần gọi (trả về tới 50 video).
• Định dạng dữ liệu: Query Parameters.

---

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

Hệ thống hỗ trợ 4 cách nhận diện Creator theo thứ tự ưu tiên:

Tham số	Kiểu	Bắt buộc	Mô tả
username	String	Khuyên dùng	Username hoặc handle của Creator (vd: "lamine.yamal" hoặc "@lamine.yamal")
profileUrl	String	Tùy chọn	Đường dẫn trang cá nhân hoặc short link (vd: https://www.tiktok.com/@lamine.yamal)
userId	String	Tùy chọn	ID số của người dùng (vd: "7251849182371928374")
secUid	String	Tùy chọn	Chuỗi định danh 64 ký tự secUid của Creator
count	Number	Mặc định: 35	Số lượng video muốn lấy trong 1 trang (Tối đa: 50)
cursor	String/Number	Mặc định: 0	Con trỏ phân trang (lấy từ trường cursor của lần gọi trước)
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 cung cấp username (ví dụ: lamine.yamal), hệ thống StackVid sẽ tự động phân giải và quét dữ liệu mà không cần cấu hình phức tạp.

---

4. Code Mẫu Gọi API

cURL

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

Node.js (Axios)

import axios from 'axios';

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

  const { itemList, hasMore, cursor: nextCursor } = response.data;
  console.log(`Đã lấy được ${itemList.length} video của @${username}`);

  for (const post of itemList) {
    console.log(`- Tiêu đề: ${post.desc}`);
    console.log(`  Link tải sạch: ${post.downloadNoWatermarkUrl}`);
    if (post.products?.length) {
      console.log(`  🛒 Giỏ hàng: ${post.products[0].title} (ID: ${post.products[0].productId})`);
    }
  }

  return { itemList, nextCursor, hasMore };
}

fetchCreatorVideos('lamine.yamal');

Python (requests)

import requests

def get_user_posts(username, count=10, cursor=0):
    url = "https://api.stackvid.dev/api/tiktok/user/posts"
    headers = {"X-API-Key": "tk_live_YOUR_API_KEY"}
    params = {
        "username": username,
        "count": count,
        "cursor": cursor
    }
    
    res = requests.get(url, headers=headers, params=params)
    data = res.json()
    
    for item in data.get("itemList", []):
        print(f"Tiêu đề: {item.get('desc')}")
        print(f"Link tải sạch: {item.get('downloadNoWatermarkUrl')}")
        products = item.get("products", [])
        if products:
            print(f"🛒 Giỏ hàng ({len(products)}): {products[0].get('title')} (ID: {products[0].get('productId')})")
        print("---------------------------------")
        
    return data

get_user_posts("lamine.yamal")

---

5. Dữ Liệu Trả Về Mẫu (Response JSON)

{
  "success": true,
  "itemList": [
    {
      "id": "7419827361528172819",
      "desc": "Bộ sưu tập thể thao năng động mùa hè 🔥 #fashion #sport #fyp",
      "createTime": 1727182900,
      "downloadNoWatermarkUrl": "https://api.stackvid.dev/api/tiktok/download?url=7419827361528172819",
      "video": {
        "width": 1080,
        "height": 1920,
        "format": "mp4",
        "size": 18500200,
        "videoID": "v14044g50000dan5qe7og65mk26sen3g",
        "bitrates": [
          {
            "gearName": "adapt_lowest_1080_1",
            "qualityType": 2,
            "bitrate": 1951034,
            "fps": 60,
            "codecType": "h265_hvc1",
            "format": "mp4",
            "width": 1080,
            "height": 1920,
            "size": 18500200,
            "playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/..."
          }
        ]
      },
      "music": {
        "id": "7182938475619283746",
        "title": "See Tình (Remix)",
        "duration": 45,
        "isCommerceMusic": true,
        "original": false,
        "isCopyrighted": true
      },
      "products": [
        {
          "productId": "1731402508560140405",
          "title": "Áo Thun Thể Thao Nam Chạy Bộ Co Giãn 4 Chiều",
          "keyword": "Áo Thun Thể Thao",
          "coverUrl": "https://p16-oec-va.ibyteimg.com/tos-maliva-i-oec22/1731402508560140405.jpeg"
        }
      ]
    }
  ],
  "cursor": "1727092817000",
  "hasMore": true
}