# Get a TikTok video's metadata and stats 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. ## Example call Over REST, send the input in the body. Over MCP, pass the same input to `call_tool`. cURL: ```bash 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"}}' ``` Python: ```python 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()) ``` TypeScript: ```ts 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()); ``` MCP (`tools/call` params): ```json { "name": "call_tool", "arguments": { "tool": "tiktok.video.detail", "input": { "video_id": "7606449212716305678" } } } ``` Both return [the full response](/docs/call-response.md): the call's ID, status and cost, with this tool's result in `output`. ## Input | Input | Type | Required | Default | Description | | --- | --- | --- | --- | --- | | `video_id` | string | Yes | | 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`. | Field | Type | Required | Description | | --- | --- | --- | --- | | `id` | string | Yes | TikTok's numeric identifier of the video, as a string. The video is at https://www.tiktok.com/@/video/ followed by it. | | `url` | string | No | Address of the video on tiktok.com. | | `text` | string | No | The video's caption, hashtags and mentions included. | | `published_at` | string | No | When the video was published, in ISO 8601. | | `duration_ms` | integer | No | Length of the video, in milliseconds. | | `width` | integer | No | Width of the video, in pixels. | | `height` | integer | No | Height of the video, in pixels. | | `preview_image_url` | string | No | Address of the video's cover image. TikTok's media addresses expire. | | `author_id` | string | No | TikTok's numeric identifier of the author, as a string. | | `author_sec_uid` | string | No | TikTok's secure identifier of the author, which tiktok.user.videos takes as sec_uid. | | `author_username` | string | No | The author's handle, without the @. | | `author_name` | string | No | The author's display name. | | `author_image_url` | string | No | Address of the author's profile picture. | | `author_verified` | boolean | No | Whether TikTok marks the author as verified. | | `author_follower_count` | integer | No | | | `view_count` | integer | No | Number of times the video was played. | | `like_count` | integer | No | | | `comment_count` | integer | No | | | `share_count` | integer | No | | | `bookmark_count` | integer | No | Number of times the video was saved to favorites. | | `approx_author_follower_count` | integer | No | Number of the author's followers, approximate, rounded by the source (28.8M is 28800000). | | `approx_view_count` | integer | No | Number of times the video was played, approximate, rounded by the source (33.3M is 33300000). | | `approx_like_count` | integer | No | Number of likes, approximate, rounded by the source (2.1M is 2100000). | | `approx_comment_count` | integer | No | Number of comments, approximate, rounded by the source (12.5K is 12500). | | `approx_share_count` | integer | No | Number of shares, approximate, rounded by the source (12.5K is 12500). | | `approx_bookmark_count` | integer | No | Number of times the video was saved to favorites, approximate, rounded by the source (90.6K is 90600). | | `hashtags` | array of string | No | Each hashtag in the caption, without the | | `mentioned_usernames` | array of string | No | Handle of each account the caption mentions, without the @. | | `music_id` | string | No | TikTok's identifier of the video's sound. | | `music_title` | string | No | Title of the video's sound. | | `music_author_name` | string | No | Name of the artist or account the sound is credited to. | ## Example output The `output` of a real call, each list cut to 3 items. ```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" } } ```