POST
/
v1
/
tiktok
/
video
curl -X POST https://api.zocialmine.com/v1/tiktok/video \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@username/video/7513452345255103751"
  }'

{
  "status": "success",
  "data": {
    "id": "7513452345255103751",
    "desc": "Video description #hashtag",
    "createTime": 1700000000,
    "author": {
      "id": "6943345678901234567",
      "uniqueId": "username",
      "nickname": "Display Name"
    },
    "stats": {
      "diggCount": 150000,
      "shareCount": 5000,
      "commentCount": 3200,
      "playCount": 2500000
    },
    "video": {
      "duration": 30,
      "cover": "https://p16-sign.tiktokcdn.com/...",
      "downloadAddr": "https://v16.tiktokcdn.com/..."
    }
  }
}
Extracts metadata from a single TikTok video URL, including stats, author info, and media URLs. Cost: 1 credit per request.

​
Request

​
url
string
required
The TikTok video URL.Example: https://www.tiktok.com/@username/video/7513452345255103751
​
webhook
string
A URL to receive the response via webhook. If provided, the request will be processed asynchronously and the result will be sent to this URL.

​
Response

​
status
string
"success" on successful request.
​
data
object
The video metadata including stats, author info, and download addresses.
curl -X POST https://api.zocialmine.com/v1/tiktok/video \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@username/video/7513452345255103751"
  }'

{
  "status": "success",
  "data": {
    "id": "7513452345255103751",
    "desc": "Video description #hashtag",
    "createTime": 1700000000,
    "author": {
      "id": "6943345678901234567",
      "uniqueId": "username",
      "nickname": "Display Name"
    },
    "stats": {
      "diggCount": 150000,
      "shareCount": 5000,
      "commentCount": 3200,
      "playCount": 2500000
    },
    "video": {
      "duration": 30,
      "cover": "https://p16-sign.tiktokcdn.com/...",
      "downloadAddr": "https://v16.tiktokcdn.com/..."
    }
  }
}