List a TikTok user's recent videos

POST/v1/tools/tiktok.user.videos/callsNeeds an API key

Returns a TikTok user's recent videos, with engagement counts, a page at a time. Use it to follow an account's content.

Tool tiktok.user.videos 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

sec_uidstringRequired

TikTok's secure identifier of the user. Take it from user.sec_uid of tiktok.user.profile, or author_sec_uid of a video.

next_page_tokenstring

Fetches the next page. Take it from pagination.next_page_token of the previous page, and send the same sec_uid.

Output

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

`videos`

A list of rows. Always present, possibly empty.

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.

`pagination`

One object. Can be null. How to fetch the next page. Null on the last page.

next_page_tokenstringRequired

Send as next_page_token to fetch the next page.

curl https://api.voxoria.ai/v1/tools/tiktok.user.videos/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"sec_uid":"MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM"}}'

import os

import httpx

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

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

{
  "name": "call_tool",
  "arguments": {
    "tool": "tiktok.user.videos",
    "input": {
      "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM"
    }
  }
}

200 OKoutputapplication/json

{
  "videos": [
    {
      "id": "7700680369246358815",
      "url": null,
      "text": "TikTok asked. @Aston Martin Aramco F1 Team answered. 🏎️🏁 @allena holzworth goes behind the scenes in the garage at Austin for Search Files. 🔎",
      "published_at": "2026-10-25T18:53:00Z",
      "duration_ms": 74000,
      "width": 720,
      "height": 1280,
      "preview_image_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ooAASpEQIEAqKN3fpUFVeCGcWAA42EAIDClRAk~tplv-tiktokx-origin.image?dr=9636&x-expires=1793332800&x-signature=EGh7shjDWL51NNsf6jJYVk2tQ08%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
      "author_id": "107955",
      "author_sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
      "author_username": "tiktok",
      "author_name": "TikTok",
      "author_image_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=bc102787&x-expires=1793332800&x-signature=YvpYWckR5tK8e%2FLw1saOLbSfOoM%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": 96500000,
      "approx_view_count": 314800,
      "approx_like_count": 3462,
      "approx_comment_count": 1410,
      "approx_share_count": 341,
      "approx_bookmark_count": 315,
      "hashtags": null,
      "mentioned_usernames": [
        "astonmartinf1",
        "allenaholzworth"
      ],
      "music_id": "7700680397922814751",
      "music_title": "original sound",
      "music_author_name": "TikTok"
    },
    {
      "id": "7700009319382650142",
      "url": null,
      "text": "The best part of searching a new city on TikTok? Discovering the people who give it flavour. 🍵 Racing car driver Jak Crawford 🏎️🏁 meets the team behind @mori in Austin this race weekend.",
      "published_at": "2026-10-23T23:29:02Z",
      "duration_ms": 107000,
      "width": 720,
      "height": 1280,
      "preview_image_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/okBlwDRE5btvzvAEVAii9AbaOEI9PktAuBA37~tplv-tiktokx-origin.image?dr=9636&x-expires=1793332800&x-signature=J6M2fnwtlizf5uLUWjDwOow9mmM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
      "author_id": "107955",
      "author_sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
      "author_username": "tiktok",
      "author_name": "TikTok",
      "author_image_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=bc102787&x-expires=1793332800&x-signature=YvpYWckR5tK8e%2FLw1saOLbSfOoM%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": 96500000,
      "approx_view_count": 309500,
      "approx_like_count": 5552,
      "approx_comment_count": 1456,
      "approx_share_count": 450,
      "approx_bookmark_count": 437,
      "hashtags": null,
      "mentioned_usernames": [
        "morimatcha__"
      ],
      "music_id": "7700009421400869662",
      "music_title": "original sound",
      "music_author_name": "TikTok"
    },
    {
      "id": "7698770783367171359",
      "url": null,
      "text": "The throwback sounds we didn’t know we were missing, brought back to life on the FYF 💖 @Adam Barrera unpacks how nostalgia took over TikTok.",
      "published_at": "2026-10-20T15:23:03Z",
      "duration_ms": 105000,
      "width": 720,
      "height": 1280,
      "preview_image_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oYiO1Aj1aA7yiGqAi938DIhBKXXfIw5ACi9AEB~tplv-tiktokx-origin.image?dr=9636&x-expires=1793332800&x-signature=HSVC%2FUMCw2FVlIXL4rsBbxnkMJ8%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
      "author_id": "107955",
      "author_sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
      "author_username": "tiktok",
      "author_name": "TikTok",
      "author_image_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=bc102787&x-expires=1793332800&x-signature=YvpYWckR5tK8e%2FLw1saOLbSfOoM%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": 96500000,
      "approx_view_count": 394000,
      "approx_like_count": 7089,
      "approx_comment_count": 1960,
      "approx_share_count": 655,
      "approx_bookmark_count": 607,
      "hashtags": null,
      "mentioned_usernames": [
        "adambarrera"
      ],
      "music_id": "7698770883132853023",
      "music_title": "original sound",
      "music_author_name": "TikTok"
    }
  ],
  "pagination": {
    "next_page_token": "pt1.dGlraHViOjE3ODg0NDQyMTkwMDA"
  }
}

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