↑ ↓ to move ↵ to open
TikTok API · Endpoint

TikTok User Videos API

List a creator's public videos, latest or most popular first, with caption, plays, likes, comments, shares and post time.

  • 1 credit per call
  • Failed calls are free
  • Updated
  • tiktok.user.videos
Response completed
{  "has_more": true,  "result_count": 20,  "items": [    {      "like_count": 1263,      "comment_count": 173,      "author_handle": "tiktok",      "create_time": 1791209149,      "description": "Real conversations happen on TikTok, and protecting the integrity of elections is a top priority. 🗳️🔐 Through dedicated in-app Election Cent…",      "id": "7693184538704416031",      "music_title": "original sound",      "play_count": 17600,      "save_count": 73,      "share_count": 67    },    {      "like_count": 4295,      "comment_count": 1956,      "author_handle": "tiktok",      "create_time": 1790959957,      "description": "ATEEZ on the FYF. BTS on tour. dance challenges on repeat. @rachelszero and friends reminisce on K-Pop Summer on TikTok",      "id": "7692114317151423775",      "music_title": "original sound",      "play_count": 271300,      "save_count": 402,      "share_count": 431    }  ]}
Try it live, free
Input

What you send

The input object of the request, with every field the endpoint accepts.

FieldTypeRequiredWhat it doesExample
handle string one of The creator's handle. tiktok
sec_uid string one of The creator's secure ID from a profile response, as an alternative to the handle.
count integer no About how many videos to return. TikTok can send a few more or fewer.
cursor integer no Pass cursor from the last response to get the next page.
sort_by string no Latest videos first, or the most popular. latest · popular
target_user_id string no The creator's numeric user ID, when you have it.
Response

Fields it returns

What each record in the response holds, with the values from the sample above.

FieldTypeWhat it isExample
items[].description string The video's caption. Real conversations happen on TikTok, and protecting the integri…
items[].play_count integer Views, as TikTok shows them. 17,600
items[].like_count integer Likes, as TikTok shows them. 1263
items[].comment_count integer Comments, as TikTok shows them. 173
items[].share_count integer Shares, as TikTok shows them. 67
items[].create_time integer When the video was posted, as a Unix time in seconds. 1,791,209,149
items[].author_handle string The posting account's handle. tiktok
items[].id string TikTok's ID for the video. 7693184538704416031
items[].music_title string The title of the sound the video uses. original sound
items[].save_count integer Saves, as TikTok shows them. 73
has_more boolean Whether more videos are available. true
items array The account's videos. 20 records
result_count integer How many videos this answer holds. 20
REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "tiktok.user.videos",  "input": {    "handle": "tiktok"  }}'
In your AI agent Claude · Cursor · any MCP client
1Add the Upscrape MCP server
https://data.upscrape.com/mcp
2Ask for the data in plain words

With Upscrape, pull @tiktok's latest videos and make a table of caption, plays, likes and comments. Which ones got the most plays?

The agent finds the endpoint, shows you the price, and runs it with your credits.
TikTok

More from the TikTok API

Same data, other platforms

The same data from other platforms

Questions

TikTok User Videos API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.
How much does the TikTok User Videos API cost?

1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.

What do I send?

Send handle or sec_uid. The input fields below list every option with its type and limits.

Do I need a TikTok login?

No. It reads public TikTok data; nothing runs on your account.

Can my AI agent call it?

Yes, over MCP: the agent finds tiktok.user.videos, checks its price and runs it with the same credits as the REST API.

Get started

Your first TikTok call is free.

Up to 100 free credits to start, no card needed.