POST
/
v1
/
tiktok
/
videos
curl -X POST https://api.zocialmine.com/v1/tiktok/videos \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@username",
    "sort": "popular",
    "cursor": "0"
  }'

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "7513452345255103751",
        "desc": "Video description",
        "createTime": 1700000000,
        "stats": {
          "diggCount": 150000,
          "playCount": 2500000,
          "commentCount": 3200,
          "shareCount": 5000
        }
      }
    ],
    "hasMore": true,
    "cursor": "1700000000000"
  }
}
Fetches a paginated list of videos from a TikTok user profile. Returns 35 videos per page (excluding pinned videos) with cursor-based pagination. Videos can be sorted by latest (default) or popular. Cost: 1 credit per request.

​
Request

​
url
string
required
The TikTok profile URL.Example: https://www.tiktok.com/@username
​
secUid
string
The user’s secUid. Auto-extracted from the URL if not provided.
​
sort
string
default:"latest"
Sort order for the videos. Accepted values:
  • "latest" — Sort by most recent (default)
  • "popular" — Sort by most popular
​
cursor
string
default:"0"
Pagination cursor. Use "0" for the first page, then pass the returned cursor value for subsequent pages.
​
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
curl -X POST https://api.zocialmine.com/v1/tiktok/videos \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@username",
    "sort": "popular",
    "cursor": "0"
  }'

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "7513452345255103751",
        "desc": "Video description",
        "createTime": 1700000000,
        "stats": {
          "diggCount": 150000,
          "playCount": 2500000,
          "commentCount": 3200,
          "shareCount": 5000
        }
      }
    ],
    "hasMore": true,
    "cursor": "1700000000000"
  }
}