Get one video in full
One TikTok video by numeric id or URL, in the same shape every other route returns videos in: caption, timestamp, duration, cover, assets, engagement stats, author, music, hashtags, mentions, ad flag and language. A shortened share link (vm.tiktok.com, vt.tiktok.com) carries nothing about its target and is rejected with a 400 — open it and pass the full URL, or run it through resolve-url first. Use the comments endpoint for the comments on it. Billing: 1 credit.
/video-detail Videos https://api.fetchlayer.dev/tiktok/video-detail Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
video string required A video URL or a numeric video id. Shortened share links are rejected — resolve them first.
format string optional json or markdown. Markdown returns a rendered summary instead of the structured record. (default: json)
timeoutMs integer optional Time limit for each individual page read, in milliseconds (max 60000). It bounds one page, not the whole request.
Response Fields
video-detail
Get one video in full
transport string The upstream source. Always "tiktok".
notes string[] Caveats you can act on — a private account, comments turned off, a list that ran out early, paging that has gone as deep as it goes. Empty when there are none. An empty result always comes with a note explaining it, never as an unexplained empty array.
pagesFetched number Pages of results read, which is what the request costs: one credit per page. resolve-url reports 0 and is not billed.
video object The video, in the shape below.
video.id string Numeric video id, which video-detail and comments both accept.
video.url string Canonical link to the video. This is what you use to open or embed it.
video.description string The caption, or null when there is none.
video.createdAt string ISO 8601 timestamp of when it was posted, or null.
video.durationSeconds number Length in seconds, or null.
video.isPhotoPost boolean True for a photo carousel rather than a clip.
video.coverUrl string The cover frame. An image, so it re-fetches through GET /media normally.
video.assets object[] An ordered list, so a clip and a carousel are handled the same way: a clip yields one asset of kind "video", a carousel one of kind "image" per frame. Each carries url, width, height and downloadUrl.
video.assets[].downloadUrl string Pass it to GET /media to stream the bytes. It serves images — carousel frames and cover images. A clip's bytes cannot be fetched by anyone, so asking for one returns 404 (see the media endpoint).
video.stats object playCount, diggCount, commentCount, shareCount, collectCount and repostCount. A null counter means TikTok did not publish that figure; a real zero comes back as 0.
video.author object id, uniqueId, nickname, avatarUrl, signature, verified, privateAccount, profileUrl and secUid.
video.music object id, title, authorName, durationSeconds, original, coverUrl, playUrl and url, or null.
video.hashtags string[] Without the #, read from TikTok’s own annotations rather than parsed out of the caption.
video.mentions string[] Usernames without the @.
video.isAd boolean True when TikTok marks the post as promotional, or null when it says nothing.
video.language string The language TikTok assigned to the caption, or null.
Request
curl -X POST "https://api.fetchlayer.dev/tiktok/video-detail" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"video":"https://www.tiktok.com/@nasa/video/7686148096895569165"}'Response
{
"transport": "tiktok",
"notes": [],
"pagesFetched": 1,
"video": {
"id": "7686148096895569165",
"url": "https://www.tiktok.com/@nasa/video/7686148096895569165",
"description": "Turns out you can dance in space! 🪩🕺💫🛰️ Microgravity just unlocked some new moves.",
"createdAt": "2026-09-16T15:00:41.000Z",
"durationSeconds": 58,
"isPhotoPost": false,
"coverUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/...",
"assets": [
{
"kind": "video",
"url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/...",
"width": 720,
"height": 1280,
"downloadUrl": "https://api.fetchlayer.dev/tiktok/media?url=..."
}
],
"stats": {
"playCount": 27600,
"diggCount": 4367,
"commentCount": 173,
"shareCount": 104,
"collectCount": 273,
"repostCount": 0
},
"author": {
"id": "7664638705177150477",
"uniqueId": "nasa",
"nickname": "NASA",
"verified": true,
"privateAccount": false,
"profileUrl": "https://www.tiktok.com/@nasa"
},
"music": {
"id": "7686148224364694286",
"title": "original sound - NASA",
"authorName": "NASA",
"durationSeconds": 58,
"original": false,
"url": "https://www.tiktok.com/music/x-7686148224364694286"
},
"hashtags": [],
"mentions": [],
"isAd": false,
"language": "en"
}
}