Get a TikTok video's metadata and stats

POST/v1/tools/tiktok.video.detail/callsNeeds an API key

Returns one TikTok video's caption, author, music and engagement counts. Use it to check how a known video performs.

Tool tiktok.video.detail on TikTok. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

video_idstringRequired

TikTok's numeric identifier of the video, the digits after /video/ in its address.

Matches ^[0-9]+$.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`video`

One object. Can be null.

idstringRequired

TikTok's numeric identifier of the video, as a string. The video is at https://www.tiktok.com/@<author_username>/video/ followed by it.

urlstring

Address of the video on tiktok.com.

textstring

The video's caption, hashtags and mentions included.

published_atstring

When the video was published, in ISO 8601.

duration_msinteger

Length of the video, in milliseconds.

widthinteger

Width of the video, in pixels.

heightinteger

Height of the video, in pixels.

preview_image_urlstring

Address of the video's cover image. TikTok's media addresses expire.

author_idstring

TikTok's numeric identifier of the author, as a string.

author_sec_uidstring

TikTok's secure identifier of the author, which tiktok.user.videos takes as sec_uid.

author_usernamestring

The author's handle, without the @.

author_namestring

The author's display name.

author_image_urlstring

Address of the author's profile picture.

author_verifiedboolean

Whether TikTok marks the author as verified.

author_follower_countinteger

view_countinteger

Number of times the video was played.

like_countinteger

comment_countinteger

share_countinteger

bookmark_countinteger

Number of times the video was saved to favorites.

approx_author_follower_countinteger

Number of the author's followers, approximate, rounded by the source (28.8M is 28800000).

approx_view_countinteger

Number of times the video was played, approximate, rounded by the source (33.3M is 33300000).

approx_like_countinteger

Number of likes, approximate, rounded by the source (2.1M is 2100000).

approx_comment_countinteger

Number of comments, approximate, rounded by the source (12.5K is 12500).

approx_share_countinteger

Number of shares, approximate, rounded by the source (12.5K is 12500).

approx_bookmark_countinteger

Number of times the video was saved to favorites, approximate, rounded by the source (90.6K is 90600).

hashtagsarray of string

Each hashtag in the caption, without the

mentioned_usernamesarray of string

Handle of each account the caption mentions, without the @.

music_idstring

TikTok's identifier of the video's sound.

music_titlestring

Title of the video's sound.

music_author_namestring

Name of the artist or account the sound is credited to.

curl https://api.voxoria.ai/v1/tools/tiktok.video.detail/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"video_id":"7606449212716305678"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/tiktok.video.detail/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={"input": {"video_id": "7606449212716305678"}},
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/tiktok.video.detail/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"input": {"video_id": "7606449212716305678"}}),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "tiktok.video.detail",
    "input": {
      "video_id": "7606449212716305678"
    }
  }
}

200 OKoutputapplication/json

{
  "video": {
    "id": "7606449212716305678",
    "url": null,
    "text": "The best TikTok dance rn 😮‍💨 @Zoe Dang @kimberly kim #zoedang #kimberlykim #lamamadelamama #realcj #dancechallenge ",
    "published_at": "2026-02-13T20:28:14Z",
    "duration_ms": 23000,
    "width": 720,
    "height": 1280,
    "preview_image_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ocAmi4yqDICVhP5lAKFASoRcWCfGpADEEcgfEj~tplv-tiktokx-origin.image?dr=9636&x-expires=1793332800&x-signature=TrsU5s%2Fto%2B1mW6a2VKiRsebBiiU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
    "author_id": "24645153",
    "author_sec_uid": "MS4wLjABAAAAnEkPI9XFOsqCQsqG7-JvND26SkmF2tHOSrDVR5abC0k",
    "author_username": "flighthouse",
    "author_name": "flighthouse",
    "author_image_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/dbf978a5746e203e480ebce90c3d122d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=7e655521&x-expires=1793332800&x-signature=UcAy7mtDHRooDkzF%2BDu2YxWX7Mw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
    "author_verified": true,
    "author_follower_count": null,
    "view_count": null,
    "like_count": null,
    "comment_count": null,
    "share_count": null,
    "bookmark_count": null,
    "approx_author_follower_count": 28800000,
    "approx_view_count": 33600000,
    "approx_like_count": 2100000,
    "approx_comment_count": 1068,
    "approx_share_count": 9908,
    "approx_bookmark_count": 91400,
    "hashtags": [
      "zoedang",
      "kimberlykim",
      "lamamadelamama"
    ],
    "mentioned_usernames": [
      "zoedang1",
      "kimberlykimpena"
    ],
    "music_id": "7240110572024645634",
    "music_title": "La Mamá de la Mamá",
    "music_author_name": "El Alfa & El Cherry Scom & CJ"
  }
}

The output of a real call, each list cut to 3 items.