Crawl Creator Posts & Video Feed

The GET /api/tiktok/user/posts endpoint scrapes published posts from any TikTok creator account, delivering watermark-free download URLs, bitrate stream arrays, and embedded TikTok Shop showcase product anchors.

---

1. Capabilities

1. Clean Watermark-Free Download URL (downloadNoWatermarkUrl): Direct download link for high-resolution MP4 video without logos.
2. Technical Streams & Multi-Bitrates (video): Dimensions (width, height), format, file size in bytes, and available resolution variants (bitrates) up to 1080p60.
3. TikTok Shop Product Anchors (products): Automatically extracts and parses attached shopping showcase items (Product ID productId, title, keyword, and thumbnail coverUrl).
4. Official Sound & Music Info (music): Sound ID, title, duration, and commercial use license verification (isCommerceMusic).
5. Cursor Pagination (cursor, hasMore): Traverse complete account historical feeds.

---

2. Specifications & Cost

• Endpoint: GET /api/tiktok/user/posts
• Credit Cost: 1 Credit per call (returns up to 50 videos).

---

3. Query Parameters

Parameter	Type	Required	Description
username	String	Recommended	Creator handle (e.g. "lamine.yamal" or "@lamine.yamal")
profileUrl	String	Optional	Profile link or shortlink
userId	String	Optional	Numeric user ID (e.g. "7251849182371928374")
secUid	String	Optional	64-character TikTok secUid
count	Number	Default: 35	Items per page (max: 50)
cursor	String/Number	Default: 0	Pagination cursor
proxyUrl	String	Optional	Custom proxy URL

---

4. Code Examples

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, count: 10 },
    headers: { 'X-API-Key': 'tk_live_YOUR_API_KEY' },
  });

  const { itemList, hasMore, cursor } = response.data;
  console.log(`Fetched ${itemList.length} videos from @${username}`);

  for (const post of itemList) {
    console.log(`- Title: ${post.desc}`);
    console.log(`  Download URL: ${post.downloadNoWatermarkUrl}`);
    if (post.products?.length) {
      console.log(`  🛒 Product: ${post.products[0].title} (ID: ${post.products[0].productId})`);
    }
  }

  return { itemList, cursor, 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"Title: {item.get('desc')}")
        print(f"Download URL: {item.get('downloadNoWatermarkUrl')}")
        products = item.get("products", [])
        if products:
            print(f"🛒 Product: {products[0].get('title')} (ID: {products[0].get('productId')})")
        print("---------------------------------")
        
    return data

get_user_posts("lamine.yamal")

---

5. Sample Response (200 OK)

{
  "success": true,
  "itemList": [
    {
      "id": "7419827361528172819",
      "desc": "Training session highlights ahead of the big match! ⚽ #football #laliga",
      "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": "Athletic Breathable Performance T-Shirt",
          "keyword": "Athletic T-Shirt",
          "coverUrl": "https://p16-oec-va.ibyteimg.com/tos-maliva-i-oec22/1731402508560140405.jpeg"
        }
      ]
    }
  ],
  "cursor": "1727092817000",
  "hasMore": true
}