Get TikTok video details

Look up metadata for a TikTok video by id or URL.

← All TikTok endpoints · Capability overview

GET/v1/tiktok/video-details

https://api.vee3.io/v1/tiktok/video-details

1 tokens

Look up metadata for a TikTok video by id or URL.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_tiktok_video_details

Parameters2 fields

video_idstringOptional

TikTok video id.

max length 32

video_urlstringOptional

TikTok video URL.

max length 2048

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/video-details"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "video_id": "7516594811734854943"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Video metadata including play URLs and music info.

video_metadata.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.2779,
  "data": {
    "id": "7516594811734854943",
    "title": "make your money count",
    "play": "https://v16-webapp-prime.tiktok.com/video/example-play.mp4",
    "hdplay": "https://v16-webapp-prime.tiktok.com/video/example-hdplay.mp4",
    "author": {
      "uniqueId": "tiktok",
      "nickname": "TikTok"
    },
    "music_info": {
      "id": "6974398592418809857",
      "title": "Bad Habits",
      "play": "https://v16-webapp-prime.tiktok.com/music/example.mp3"
    }
  }
}