TikTok API: Get video
Gets details and engagement statistics for one public TikTok video from its link, including vm.tiktok.com short links: creator, caption, hashtags, posting time, views, likes, comments, shares, length and sound.
Unofficial. Not affiliated with or endorsed by TikTok.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Video, required
video Link to a public TikTok video, including a vm.tiktok.com short link. Example: https://www.tiktok.com/@scout2015/video/6718335390845095173
https://vm.tiktok.com/ZMkyTWLpV/
Input as JSON
{ "video": "https://vm.tiktok.com/ZMkyTWLpV/" }Output
{ "likes": 2400000, "saves": null, "views": 17000000, "length": "0:14", "shares": 374800, "caption": "The collab you’ve all been waiting for #maxwell #dingus #maxwellthecat #dingusthecat #cat #gamedev #capybara #meme #fyp ", "comments": 32900, "hashtags": [ "maxwell", "dingus", "maxwellthecat" ], "video_id": "7179163174057364742", "sound_name": "Stock Market", "video_link": "https://www.tiktok.com/@matatogames/video/7179163174057364742" , "sound_artist": "Mr Weebl", "length_seconds": 14, "cover_image_link": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/43db0a8c64b647429202adf0ce39eb91_1727624995~tplv-tiktokx-origin.image?dr=9636&x-expires=1790816400&x-signature=Ag6MTzk3ykTuwcn65oY%2Bbvj1zAg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5" , "creator_username": "matatogames", "posted_date_time": "2022-12-20T09:39:49+00:00", "creator_display_name": "Matato"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"tiktok.com/get_video","input":{"video":"https://vm.tiktok.com/ZMkyTWLpV/"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "tiktok.com/get_video" , "input": { "video": "https://vm.tiktok.com/ZMkyTWLpV/" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "tiktok.com/get_video" , "input": { "video": "https://vm.tiktok.com/ZMkyTWLpV/" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run tiktok.com/get_video# with {"video":"https://vm.tiktok.com/ZMkyTWLpV/"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "video" ], "properties": { "video": { "type": "string", "minLength": 1, "description": "Link to a public TikTok video, including a vm.tiktok.com short link. Example: https://www.tiktok.com/@scout2015/video/6718335390845095173" } }}Output schema
{ "type": "object", "required": [ "creator_username", "creator_display_name", "caption", "hashtags", "posted_date_time", "views", "likes", "comments", "shares", "saves", "length", "sound_name", "sound_artist", "cover_image_link", "video_link", "video_id", "length_seconds" ], "properties": { "likes": { "type": "integer", "description": "Number of likes." }, "saves": { "type": [ "integer", "null" ], "description": "Number of saves, when publicly available; otherwise null." }, "views": { "type": "integer", "description": "Number of views." }, "length": { "type": "string", "description": "Video length as minutes and seconds, for example 1:02." }, "shares": { "type": "integer", "description": "Number of shares." }, "caption": { "type": "string", "description": "Caption of the video." }, "comments": { "type": "integer", "description": "Number of comments." }, "hashtags": { "type": "array", "items": { "type": "string" }, "description": "Hashtags without the # symbol." }, "video_id": { "type": "string", "description": "TikTok video ID." }, "sound_name": { "type": [ "string", "null" ], "description": "Name of the sound." }, "video_link": { "type": "string", "description": "Link to the video page." }, "sound_artist": { "type": [ "string", "null" ], "description": "Artist or creator of the sound." }, "length_seconds": { "type": "integer", "description": "Video length in seconds." }, "cover_image_link": { "type": [ "string", "null" ], "description": "Link to the video cover image." }, "creator_username": { "type": "string", "description": "TikTok username of the creator." }, "posted_date_time": { "type": "string", "description": "Video posting time in ISO 8601 with a UTC offset." }, "creator_display_name": { "type": [ "string", "null" ], "description": "Display name of the creator." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
tiktok.com/get_video- Returns
- creator, caption, hashtags, posted time, views, likes, comments, shares, saves, length, sound, cover image, video link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method tiktok.com/get_video with the inputs above.
Ask your agent
- How many views and likes does this video have right now? https://www.tiktok.com/@khaby.lame/video/7194938457562172715
- Pull the caption, hashtags and sound used in https://vm.tiktok.com/ZMr8xKpQ2/ — I want to reuse the trending audio
- I need engagement stats (comments, shares, saves) for my client's TikTok post: https://www.tiktok.com/@gymshark/video/7301122458890125614
- When was this clip posted and how long is it? https://www.tiktok.com/@nasa/video/7268451093327720746
- Who made this TikTok and what's the cover image? Link: https://vm.tiktok.com/ZGeT4nYw7/
See more
All TikTok methodsGets a TikTok creator's public profile and totals (followers, following, likes, videos) from a username, @handle or profile link. Profiles not visible to public visitors cannot be returned.
tiktok.com/get_profileLists publicly visible TikTok Creative Center trending hashtags by country, time period and industry. Anonymous visitors see at most three rows; rank change and new-entry status are not public and come back null.
ads.tiktok.com/list_trending_hashtagsGets a public Vimeo video's title, creator, play, like and comment counts, length, upload date, description, tags, thumbnail and link from its video link.
vimeo.com/get_videoGets public statistics and details for a Bilibili video from its link, BV number or title. A title selects the top video search match. Category may be missing when Bilibili does not show a label.
bilibili.com/get_videoGets public details and statistics for one YouTube video by link, ID or title. A title selects the top search match.
youtube.com/get_videoGets a TikTok creator's Social Blade profile totals, grade when shown, 30-day follower and like changes, and up to 14 days of daily totals, from a TikTok handle or a TikTok or Social Blade profile link. Counts reflect Social Blade's recorded and sometimes rounded figures.
socialblade.com/get_tiktok_statsGets public top-level comments on a YouTube video, found by link, video ID or title. Reply text is not included.
youtube.com/get_video_commentsGets an Instagram account's follower count plus its posting and engagement over the last 30 days: posts published, average views of its videos and reels, and average likes and comments per post, from a username or profile link.
instagram.com/get_engagement_stats_2
