/video/detailsVideo Details
Video
Cost / request
$0.01
Response format
JSON
Protocol
REST
About this endpoint
Access TikTok data through agntdata: Video Details. Return Video Details. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need video details, creator profiles, and search across accounts and videos programmatically.
Use cases
AI agents that need TikTok data in structured form
Analytics and monitoring pipelines for TikTok content
Research and GTM workflows that combine TikTok signals with other data
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| video_id | query | string | required | —Default: 7149284958899785006 |
Responses
Response
{
"type": "object",
"properties": {
"video_id": {
"type": "string"
},
"details": {
"type": "object",
"properties": {
"video_id": {
"type": "string"
},
"description": {
"type": "string"
},
"create_time": {
"type": "string"
},
"author": {
"type": "string"
},
"author_id": {
"type": "string"
},
"author_name": {
"type": "string"
},
"statistics": {
"type": "object",
"properties": {
"number_of_comments": {
"type": "integer"
},
"number_of_hearts": {
"type": "integer"
},
"number_of_plays": {
"type": "integer"
},
"number_of_reposts": {
"type": "integer"
}
}
},
"cover": {
"type": "string"
},
"download_url": {
"type": "string"
},
"video_definition": {
"type": "string"
},
"format": {
"type": "null"
},
"bitrate": {
"type": "integer"
},
"duration": {
"type": "integer"
},
"avatar_thumb": {
"type": "string"
}
}
}
}
}Agent / Developer Schema
Machine-readable formats for integrating this endpoint into AI agents and toolchains.
{
"operationId": "Video_Details",
"method": "get",
"path": "/video/details",
"summary": "Video Details",
"description": "Return Video Details",
"parameters": [
{
"name": "video_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"default": "7149284958899785006"
}
}
],
"responses": [
{
"statusCode": "200",
"description": "Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"video_id": {
"type": "string"
},
"details": {
"type": "object",
"properties": {
"video_id": {
"type": "string"
},
"description": {
"type": "string"
},
"create_time": {
"type": "string"
},
"author": {
"type": "string"
},
"author_id": {
"type": "string"
},
"author_name": {
"type": "string"
},
"statistics": {
"type": "object",
"properties": {
"number_of_comments": {
"type": "integer"
},
"number_of_hearts": {
"type": "integer"
},
"number_of_plays": {
"type": "integer"
},
"number_of_reposts": {
"type": "integer"
}
}
},
"cover": {
"type": "string"
},
"download_url": {
"type": "string"
},
"video_definition": {
"type": "string"
},
"format": {
"type": "null"
},
"bitrate": {
"type": "integer"
},
"duration": {
"type": "integer"
},
"avatar_thumb": {
"type": "string"
}
}
}
}
},
"example": {
"video_id": "7149284958899785006",
"details": {
"video_id": "7149284958899785006",
"description": "Want to work with me? Duet and show me what you got. #ziprecruiterpartner #putziprecruitertoworkforyou ",
"create_time": "1664572629",
"author": {
"id": "6614519312189947909",
"shortId": "",
"uniqueId": "mrbeast",
"nickname": "MrBeast",
"avatarLarger": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310051540889239595~c5_1080x1080.jpeg?lk3s=a5d48078&x-expires=1710262800&x-signature=Z%2FF1%2FTRQHJ5Ib4%2BKI8BheTBglCQ%3D",
"avatarMedium": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310051540889239595~c5_720x720.jpeg?lk3s=a5d48078&x-expires=1710262800&x-signature=3mcahqVuvG3zfShRsoZuG5CxZio%3D",
"avatarThumb": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310051540889239595~c5_100x100.jpeg?lk3s=a5d48078&x-expires=1710262800&x-signature=DQdwYgkb3w0fCQQ8CET0jm0EujQ%3D",
"signature": "I want to make the world a better place before I die",
"createTime": 0,
"verified": true,
"secUid": "MS4wLjABAAAABKjQkOz_IIzXXzEAl_9LGsWhvK-gBnlczwRPXK8EmxAp6K3X0qiaP5_OEqmm0XwG",
"ftc": false,
"relation": 0,
"openFavorite": false,
"commentSetting": 0,
"duetSetting": 0,
"stitchSetting": 0,
"privateAccount": false,
"secret": false,
"isADVirtual": false,
"roomId": "",
"uniqueIdModifyTime": 0,
"ttSeller": false,
"downloadSetting": 0,
"recommendReason": "",
"nowInvitationCardUrl": "",
"nickNameModifyTime": 0,
"isEmbedBanned": false,
"canExpPlaylist": false,
"suggestAccountBind": false
},
"author_id": "6614519312189947909",
"author_name": "MrBeast",
"statistics": {
"number_of_comments": 28800,
"number_of_hearts": 1900000,
"number_of_plays": 56100000,
"number_of_reposts": 10700
},
"cover": "https://p16-sign.tiktokcdn-us.com/obj/tos-useast5-p-0068-tx/c2357b5cea4d4ab7a94a563a6ea2e212_1664572630?x-expires=1710262800&x-signature=jT4m1lJQqTOplhh00r4KlEdw30g%3D",
"download_url": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/0f32e50b0d5b482f89f9dcc8bc4b2423/?a=1988&ch=0&cr=3&dr=0&lr=tiktok_m&cd=0%7C0%7C1%7C&cv=1&br=2490&bt=1245&bti=ODszNWYuMDE6&cs=0&ds=3&ft=4fUEKMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=0&rc=ZDtoNWgzOjQ3M2VnZmVmNEBpM2xycTk6Zm1vZjMzZzczNEBgNS4wYGEyNmIxYzNeMjZjYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&btag=e00088000&expire=1710112463&l=20240310171405D39DD0924DCB6AEE7C97&ply_type=2&policy=2&signature=2e195fe303d99c225082b7c2454fc348&tk=tt_chain_token",
"unwatermarked_download_url": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/f2fd769351f341768efede15d60a689d/?a=1988&ch=0&cr=3&dr=0&lr=unwatermarked&cd=0%7C0%7C0%7C&cv=1&br=2434&bt=1217&bti=ODszNWYuMDE6&cs=0&ds=6&ft=4fUEKMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=0&rc=NzdoNWc3NTQ5Njk0OzlmO0BpM2xycTk6Zm1vZjMzZzczNEAvY181YS0vX2MxMzVfXmMyYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&btag=e00088000&expire=1710112463&l=20240310171405D39DD0924DCB6AEE7C97&ply_type=2&policy=2&signature=4e49af2ee309185f3f7b4d02889c30c7&tk=tt_chain_token",
"video_definition": "540p",
"format": null,
"bitrate": 1246692,
"duration": 17,
"avatar_thumb": "https://p16-sign.tiktokcdn-us.com/obj/tos-useast5-p-0068-tx/71d873bb5cd045e1af5c8188d0aa9580_1664572630?x-expires=1710262800&x-signature=hrtXamPJfeepUbRhsGanY2ufzmg%3D",
"images": null,
"cookies": "tt_chain_token=8fZZGut3DLXgSfkILTtgEg==",
"subtitles": [
{
"UrlExpire": "1710112463",
"Size": "1060",
"LanguageID": "3",
"LanguageCodeName": "jpn-JP",
"Url": "https://v16-webapp.tiktok.com/4140cb4dc419c1b6a3ee99aac14590d3/65ee3ecf/video/tos/maliva/tos-maliva-v-0068c799-us/6195a9ae295f4d7d96021152d9b668a0/?a=1988&ch=0&cr=3&dr=0&lr=unwatermarked&cd=0%7C0%7C0%7C&cv=1&br=2434&bt=1217&bti=ODszNWYuMDE6&cs=0&ds=6&ft=4b~OyMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=13&rc=M2xycTk6Zm1vZjMzZzczNEBpM2xycTk6Zm1vZjMzZzczNEBmby9xcjRnam9gLS1kMS9zYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&l=20240310171405D39DD0924DCB6AEE7C97&btag=e00048000",
"Format": "webvtt",
"Version": "4",
"Source": "MT"
},
{
"UrlExpire": "1710112463",
"Size": "828",
"LanguageID": "23",
"LanguageCodeName": "ind-ID",
"Url": "https://v16-webapp.tiktok.com/eb36796c73cb1b06a4d511e53979341a/65ee3ecf/video/tos/maliva/tos-maliva-v-0068c799-us/55a289b4371a47e7a42690aabc8659d8/?a=1988&ch=0&cr=3&dr=0&lr=unwatermarked&cd=0%7C0%7C0%7C&cv=1&br=2434&bt=1217&bti=ODszNWYuMDE6&cs=0&ds=6&ft=4b~OyMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=13&rc=M2xycTk6Zm1vZjMzZzczNEBpM2xycTk6Zm1vZjMzZzczNEBmby9xcjRnam9gLS1kMS9zYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&l=20240310171405D39DD0924DCB6AEE7C97&btag=e00048000",
"Format": "webvtt",
"Version": "4",
"Source": "MT"
},
{
"UrlExpire": "1710112463",
"Size": "987",
"LanguageID": "20",
"LanguageCodeName": "deu-DE",
"Url": "https://v16-webapp.tiktok.com/6415cdeca3705d4ae0eb48d1e59ed984/65ee3ecf/video/tos/maliva/tos-maliva-v-0068c799-us/9b7b68f273d741ba8f23f74d886dc983/?a=1988&ch=0&cr=3&dr=0&lr=unwatermarked&cd=0%7C0%7C0%7C&cv=1&br=2434&bt=1217&bti=ODszNWYuMDE6&cs=0&ds=6&ft=4b~OyMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=13&rc=M2xycTk6Zm1vZjMzZzczNEBpM2xycTk6Zm1vZjMzZzczNEBmby9xcjRnam9gLS1kMS9zYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&l=20240310171405D39DD0924DCB6AEE7C97&btag=e00048000",
"Format": "webvtt",
"Version": "4",
"Source": "MT"
},
{
"UrlExpire": "1710112463",
"Size": "764",
"LanguageID": "2",
"LanguageCodeName": "eng-US",
"Url": "https://v16-webapp.tiktok.com/838a88cab815f74e7f7db470c60dc465/65ee3ecf/video/tos/maliva/tos-maliva-v-0068c799-us/c2d1e5e3b9884f51acd20edb01095745/?a=1988&ch=0&cr=3&dr=0&lr=unwatermarked&cd=0%7C0%7C0%7C&cv=1&br=2434&bt=1217&bti=ODszNWYuMDE6&cs=0&ds=6&ft=4b~OyMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=13&rc=M2xycTk6Zm1vZjMzZzczNEBpM2xycTk6Zm1vZjMzZzczNEBmby9xcjRnam9gLS1kMS9zYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&l=20240310171405D39DD0924DCB6AEE7C97&btag=e00048000",
"Format": "webvtt",
"Version": "1",
"Source": "ASR"
},
{
"UrlExpire": "1710112463",
"Size": "923",
"LanguageID": "4",
"LanguageCodeName": "kor-KR",
"Url": "https://v16-webapp.tiktok.com/26e4ffbfaa8039eeb899f001cba725a3/65ee3ecf/video/tos/maliva/tos-maliva-v-0068c799-us/614bd8802d6d4abfa7d0c754b3359970/?a=1988&ch=0&cr=3&dr=0&lr=unwatermarked&cd=0%7C0%7C0%7C&cv=1&br=2434&bt=1217&bti=ODszNWYuMDE6&cs=0&ds=6&ft=4b~OyMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=13&rc=M2xycTk6Zm1vZjMzZzczNEBpM2xycTk6Zm1vZjMzZzczNEBmby9xcjRnam9gLS1kMS9zYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&l=20240310171405D39DD0924DCB6AEE7C97&btag=e00048000",
"Format": "webvtt",
"Version": "4",
"Source": "MT"
},
{
"UrlExpire": "1710112463",
"Size": "824",
"LanguageID": "26",
"LanguageCodeName": "ita-IT",
"Url": "https://v16-webapp.tiktok.com/56d4715ff513ac5d7223f410cd713f0a/65ee3ecf/video/tos/maliva/tos-maliva-v-0068c799-us/b6be39b38f3447dc816d483253900879/?a=1988&ch=0&cr=3&dr=0&lr=unwatermarked&cd=0%7C0%7C0%7C&cv=1&br=2434&bt=1217&bti=ODszNWYuMDE6&cs=0&ds=6&ft=4b~OyMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=13&rc=M2xycTk6Zm1vZjMzZzczNEBpM2xycTk6Zm1vZjMzZzczNEBmby9xcjRnam9gLS1kMS9zYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&l=20240310171405D39DD0924DCB6AEE7C97&btag=e00048000",
"Format": "webvtt",
"Version": "4",
"Source": "MT"
},
{
"UrlExpire": "1710112463",
"Size": "958",
"LanguageID": "10",
"LanguageCodeName": "vie-VN",
"Url": "https://v16-webapp.tiktok.com/aaadfe72801d9da62a06398c68068143/65ee3ecf/video/tos/maliva/tos-maliva-v-0068c799-us/db664ded166343779dfee514f0abcec2/?a=1988&ch=0&cr=3&dr=0&lr=unwatermarked&cd=0%7C0%7C0%7C&cv=1&br=2434&bt=1217&bti=ODszNWYuMDE6&cs=0&ds=6&ft=4b~OyMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=13&rc=M2xycTk6Zm1vZjMzZzczNEBpM2xycTk6Zm1vZjMzZzczNEBmby9xcjRnam9gLS1kMS9zYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&l=20240310171405D39DD0924DCB6AEE7C97&btag=e00048000",
"Format": "webvtt",
"Version": "4",
"Source": "MT"
},
{
"UrlExpire": "1710112463",
"Size": "834",
"LanguageID": "8",
"LanguageCodeName": "por-PT",
"Url": "https://v16-webapp.tiktok.com/ba6320877f8d27d2fdc66aa3033abfd6/65ee3ecf/video/tos/maliva/tos-maliva-v-0068c799-us/64e045334858473c977798ac1811d15d/?a=1988&ch=0&cr=3&dr=0&lr=unwatermarked&cd=0%7C0%7C0%7C&cv=1&br=2434&bt=1217&bti=ODszNWYuMDE6&cs=0&ds=6&ft=4b~OyMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=13&rc=M2xycTk6Zm1vZjMzZzczNEBpM2xycTk6Zm1vZjMzZzczNEBmby9xcjRnam9gLS1kMS9zYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&l=20240310171405D39DD0924DCB6AEE7C97&btag=e00048000",
"Format": "webvtt",
"Version": "4",
"Source": "MT"
},
{
"UrlExpire": "1710112463",
"Size": "848",
"LanguageID": "7",
"LanguageCodeName": "fra-FR",
"Url": "https://v16-webapp.tiktok.com/1ba18913bba81b4d1b7ff713480ed550/65ee3ecf/video/tos/maliva/tos-maliva-v-0068c799-us/0f99eda48cc14ce98427453e76095010/?a=1988&ch=0&cr=3&dr=0&lr=unwatermarked&cd=0%7C0%7C0%7C&cv=1&br=2434&bt=1217&bti=ODszNWYuMDE6&cs=0&ds=6&ft=4b~OyMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=13&rc=M2xycTk6Zm1vZjMzZzczNEBpM2xycTk6Zm1vZjMzZzczNEBmby9xcjRnam9gLS1kMS9zYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&l=20240310171405D39DD0924DCB6AEE7C97&btag=e00048000",
"Format": "webvtt",
"Version": "4",
"Source": "MT"
},
{
"UrlExpire": "1710112463",
"Size": "754",
"LanguageID": "1",
"LanguageCodeName": "cmn-Hans-CN",
"Url": "https://v16-webapp.tiktok.com/6705f95034f498f95d21a37222804454/65ee3ecf/video/tos/maliva/tos-maliva-v-0068c799-us/cdbe7153c88c416f92bde47420532f38/?a=1988&ch=0&cr=3&dr=0&lr=unwatermarked&cd=0%7C0%7C0%7C&cv=1&br=2434&bt=1217&bti=ODszNWYuMDE6&cs=0&ds=6&ft=4b~OyMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=13&rc=M2xycTk6Zm1vZjMzZzczNEBpM2xycTk6Zm1vZjMzZzczNEBmby9xcjRnam9gLS1kMS9zYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&l=20240310171405D39DD0924DCB6AEE7C97&btag=e00048000",
"Format": "webvtt",
"Version": "4",
"Source": "MT"
},
{
"UrlExpire": "1710112463",
"Size": "803",
"LanguageID": "9",
"LanguageCodeName": "spa-ES",
"Url": "https://v16-webapp.tiktok.com/801f9bfce07595a1a98b7eb972d67c68/65ee3ecf/video/tos/maliva/tos-maliva-v-0068c799-us/9e2733a8002346b6ba4cda06ba9b41c1/?a=1988&ch=0&cr=3&dr=0&lr=unwatermarked&cd=0%7C0%7C0%7C&cv=1&br=2434&bt=1217&bti=ODszNWYuMDE6&cs=0&ds=6&ft=4b~OyMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=13&rc=M2xycTk6Zm1vZjMzZzczNEBpM2xycTk6Zm1vZjMzZzczNEBmby9xcjRnam9gLS1kMS9zYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&l=20240310171405D39DD0924DCB6AEE7C97&btag=e00048000",
"Format": "webvtt",
"Version": "4",
"Source": "MT"
},
{
"UrlExpire": "1710112463",
"Size": "1183",
"LanguageID": "6",
"LanguageCodeName": "rus-RU",
"Url": "https://v16-webapp.tiktok.com/661e92dd5c04132f2f95f3cabc85fd28/65ee3ecf/video/tos/maliva/tos-maliva-v-0068c799-us/f096da9dba6544c2844e377e647ac764/?a=1988&ch=0&cr=3&dr=0&lr=unwatermarked&cd=0%7C0%7C0%7C&cv=1&br=2434&bt=1217&bti=ODszNWYuMDE6&cs=0&ds=6&ft=4b~OyMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=13&rc=M2xycTk6Zm1vZjMzZzczNEBpM2xycTk6Zm1vZjMzZzczNEBmby9xcjRnam9gLS1kMS9zYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&l=20240310171405D39DD0924DCB6AEE7C97&btag=e00048000",
"Format": "webvtt",
"Version": "4",
"Source": "MT"
},
{
"UrlExpire": "1710112463",
"Size": "890",
"LanguageID": "34",
"LanguageCodeName": "ara-SA",
"Url": "https://v16-webapp.tiktok.com/d99a7bc623493196257060dc3ffcdf4a/65ee3ecf/video/tos/maliva/tos-maliva-v-0068c799-us/36339799ff5b4709a15f4b63c28c4a4f/?a=1988&ch=0&cr=3&dr=0&lr=unwatermarked&cd=0%7C0%7C0%7C&cv=1&br=2434&bt=1217&bti=ODszNWYuMDE6&cs=0&ds=6&ft=4b~OyMzm8Zmo0C9OL94jVCHJJpWrKsd.&mime_type=video_mp4&qs=13&rc=M2xycTk6Zm1vZjMzZzczNEBpM2xycTk6Zm1vZjMzZzczNEBmby9xcjRnam9gLS1kMS9zYSNmby9xcjRnam9gLS1kMS9zcw%3D%3D&l=20240310171405D39DD0924DCB6AEE7C97&btag=e00048000",
"Format": "webvtt",
"Version": "4",
"Source": "MT"
}
]
},
"type": "video"
}
}
}
},
{
"statusCode": "422",
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"title": "HTTPValidationError",
"type": "object",
"properties": {
"detail": {
"title": "Detail",
"type": "array",
"items": {
"title": "ValidationError",
"required": [
"loc",
"msg",
"type"
],
"type": "object",
"properties": {
"loc": {
"title": "Location",
"type": "array",
"items": {
"type": "string"
}
},
"msg": {
"title": "Message",
"type": "string"
},
"type": {
"title": "Error Type",
"type": "string"
}
}
}
}
}
},
"example": {
"detail": [
{
"loc": [],
"msg": "",
"type": ""
}
]
}
}
}
}
]
}Pricing
$0.01per successful request
Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.
Related endpoints
Start using this endpoint
Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.
TikTok APITikTok data APIvideo details APIAI agents data APITikTok APITikTok data APITikTok for AI agents