logo
languageENdown
menu

TikTok Video Detail

Submit up to 200 TikTok video URLs and retrieve public video, account, engagement, and media details

Data collectionSocial MediaTikTokVideos

Overview

Public TikTok video details bring together the visible caption, creator identity, engagement snapshot, and media references for videos you already know. This Data App turns a batch of TikTok video links into consistent records that are ready for review, comparison, enrichment, or storage.

Instead of opening videos one by one and copying what is visible, teams can use the result as a structured research dataset. It is especially useful when a shortlist of videos has already been identified and the next step is to compare creative themes, creator context, publishing patterns, or public engagement.

Data notes

The data covers publicly available TikTok video details for the supplied links. Each valid, deduplicated video URL returns at most one record, identified by Video ID. Invalid, duplicate, deleted, private, or login-only videos may return no record.

Like count, Comment count, Play count, Collect count, Share count, Follower count, verification, and related values are snapshots observed at collection time and may change later. Count fields are kept in the source text form. Video caption, Hashtags, Mentions, and music fields are also retained as source text. Published at, Collected at, and Record update time preserve source timestamps without inferring a timezone.

What the results look like

Each record represents the public details captured for one TikTok video.

Video IDAccount namePlay countLike countPublish countryVerified account
7457124241389915399คณะสิงโตมังกรทองลูกชัยมงคล175600652ThailandNo
7659102246143102238Luxury cars6532118United StatesNo

Additional values include account identifiers and profile links, cover and video URLs, the full caption, music metadata, collection timestamps, and the submitted URL.

Use cases

  • Compare Play count, Like count, Comment count, and Share count to identify videos with stronger visible engagement.
  • Review Video caption, Hashtags, and Mentions to classify creative themes and messaging.
  • Use Account name, Account ID, Profile URL, and Verified account to add creator context to a selected video set.
  • Compare Published at, Collected at, Video URL, and Play URL across repeated collections to monitor availability and media references.

Scope and boundaries

Each run accepts 1-200 TikTok video URLs; every valid deduplicated URL returns at most one publicly available detail record.

  • Good for
  • Use when you need detailed public metadata and engagement snapshots for a known set of TikTok video URLs
  • Use when you need up to 200 video detail records in one background task
  • Do not use for
  • Do not use to discover videos by keyword, hashtag, or account; supply known TikTok video URLs
  • Do not use for private, deleted, or login-only videos

Failure handling

Failure and retry behavior declared by the author. We recommend including it in your system prompt when integrating.

  1. 1Retry temporary task or service failures with the same video URLs
  2. 2If only part of the task succeeds, use the returned records and retry the missing video URLs
  3. 3An empty result can mean that a URL is invalid, duplicated, unavailable, or no longer public

Input

Parameters required to call this App, generated from the input.schema in manifest.json.

FieldBusiness nameTypeRequiredDefaultEnum / ConstraintsExampleDescription
video_itemsTikTok video URLsarray<object>Yes—up to 200 items[{"kw":"https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399"}]Add 1-200 entries. In each entry, put the full TikTok video URL in the Video URL field; invalid, duplicate, or inaccessible URLs may return no record.

Output

Field structure of a single record, generated from the output.schema in manifest.json.

FieldBusiness nameTypeExampleDescription
account_avatar_urlAccount avatar URLstringhttps://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-giso/775d60a4592d9e2c8f9444d6146c86ba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=8fd2219a&x-expires=1787889600&x-signature=YNGo392zpoBnhgP2xrZA4E1qzug%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8The account avatar image URL returned for this video.
account_fans_countFollower countstring74700The account follower count kept in the source text form.
account_following_countFollowing countstring260The account following count kept in the source text form.
account_heart_countAccount heart countstring—The account heart count kept in the source text form.
account_idAccount IDstring6905360269078922241The numeric TikTok account ID returned with this video.
account_nameAccount namestringคณะสิงโตมังกรทองลูกชัยมงคลThe public display name of the account.
account_secure_idAccount secure IDstringMS4wLjABAAAAB1kYoG7ow0_uy4aBS2ZdAH-tmY08IL85lod-zAzx5mh53zWaEyhH3_GzgFMubNuNThe source secure identifier of the account.
account_signatureAccount biostringติดต่อสอบถามผลงานThe public account bio returned with this video.
account_total_like_countAccount like countstring4401The account total like count kept in the source text form.
author_create_timeAccount created atstring—The account creation timestamp in source form, without inferred timezone.
biz_idBusiness IDstringhttps://www.tiktok.com/@chai_mong_kol/video/7457124241389915399The source business identifier returned with this video.
clean_update_timeRecord update timestring2026-08-26T12:58:28The source record update timestamp, without inferred timezone.
collect_countCollect countstring53The public collect count kept in the source text form.
comment_countComment countstring10The public comment count kept in the source text form.
content_idVideo IDstring7457124241389915399The TikTok video ID that uniquely identifies this record.
content_textVideo captionstring#คณะสิงโตมังกรทองลูกชัยมงคล ซ้อมใหญ่เตรียมงานตรุษจีน #ลูกชัยมงคล #สิงโตโปงลาง #สิงโตอีเว้นท์ #เชิดสิงโตอวยพร #สิงโตมงคลThe public caption text of the video.
content_urlVideo URLstringhttps://www.tiktok.com/@chai_mong_kol/video/7457124241389915399The public TikTok video URL.
country_codeCountry codestringTHThe source country code returned with this video.
crawl_timeCollected atstring2026-08-26T12:58:27The collection timestamp in source form, without inferred timezone.
cur_idRecord IDstring6a8e7274f5f83d2da3b12346The source identifier of this collected detail record.
detailed_mentionsDetailed mentionsstring—The detailed mention text returned with this video.
effect_stickersEffect stickersstring—The effect sticker text returned with this video.
hashtagsHashtagsstring—The hashtag text returned with this video.
is_adPaid adbooleanfalseWhether the video is marked as a paid ad at collection time.
is_slideshowSlideshowbooleanfalseWhether the video is marked as a slideshow at collection time.
is_verifiedVerified accountbooleanfalseWhether the account is marked verified at collection time.
keyword_listSubmitted URLstringhttps://www.tiktok.com/@chai_mong_kol/video/7457124241389915399The submitted TikTok URL associated with this result row.
like_countLike countstring652The public like count kept in the source text form.
locationLocationstring—The location text returned with this video.
mentionsMentionsstring—The mention text returned with this video.
music_albumMusic albumstring—The music album name returned with this video.
music_authorMusic authorstring—The music author name returned with this video.
music_cover_urlMusic cover URLstring—The music cover image URL returned with this video.
music_idMusic IDstring—The music identifier returned with this video.
music_nameMusic namestring—The music name returned with this video.
music_originalOriginal soundbooleanfalseWhether the sound is marked original at collection time.
music_original_cover_urlOriginal sound coverstring—The original sound cover image URL returned with this video.
music_play_urlMusic play URLstring—The music playback URL returned with this video.
play_countPlay countstring175600The public play count kept in the source text form.
private_accountPrivate accountbooleanfalseWhether the account is marked private at collection time.
profile_urlProfile URLstring—The public account profile URL.
publish_countryPublish countrystringThailandThe publish country name returned with this video.
publish_timePublished atstring2025-01-07T18:50:40The publish timestamp in source form, without inferred timezone.
repost_countRepost countstring—The public repost count kept in the source text form.
room_idLive room IDstring—The live room identifier returned with this video.
share_countShare countstring28The public share count kept in the source text form.
subtitle_linksSubtitle linksstring—The subtitle link text returned with this video.
task_itemRequested itemstringhttps://www.tiktok.com/@chai_mong_kol/video/7457124241389915399The submitted item value that produced this result row.
task_no_dataNo data flagbooleanfalseWhether the source marked this submitted item as having no detail data.
text_languageCaption languagestring—The caption language returned with this video.
tt_sellerTikTok sellerbooleanfalseWhether the account is marked as a TikTok seller at collection time.
user_friend_countFriend countstring—The account friend count kept in the source text form.
user_video_countAccount video countstring—The account video count kept in the source text form.
video_cover_urlCover URLstring—The video cover image URL.
video_definitionVideo definitionstring—The video definition label returned with this video.
video_download_addrDownload URLstring—The video download URL returned with this video.
video_durationDuration secondsinteger0The video duration in seconds.
video_formatVideo formatstring—The video format label returned with this video.
video_heightVideo heightinteger0The video height in pixels.
video_original_cover_urlOriginal video coverstring—The original video cover image URL returned with this video.
video_urlsPlay URLstringhttps://v16-webapp-prime.us.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oYLDobO0QBjLEifIFQAByIED9AzofDhCRHfV0x/?a=1988&bti=ODszNWYuMDE6&&bt=1611&ft=4KJMyMzm8Zmo0Z.tHa4jV~CCQpWrKsd.&mime_type=video_mp4&rc=OjdoNTw5Omc1OWVmOzhoZUBpamU1d3I5cnJqdzMzODczNEAvNi9eYjVjNjQxNF8wYF8zYSM1LzJzMmRrYXJgLS1kMTFzcw%3D%3D&expire=1787893156&l=202608260458202CAFAB1344990A166E7B&ply_type=2&policy=2&signature=2080d8f77af89de133812156ebbabc98&tk=tt_chain_token&btag=e000c8000The video playback URL returned with this video.
video_widthVideo widthinteger0The video width in pixels.

Record schema

Output is returned record by record. detail.output.idFieldHint

output.schema
{
  "type": "object",
  "properties": {
    "account_avatar_url": {
      "type": "string",
      "title": "Account avatar URL",
      "description": "The account avatar image URL returned for this video.",
      "prefill": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-giso/775d60a4592d9e2c8f9444d6146c86ba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=8fd2219a&x-expires=1787889600&x-signature=YNGo392zpoBnhgP2xrZA4E1qzug%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8"
    },
    "account_fans_count": {
      "type": "string",
      "title": "Follower count",
      "description": "The account follower count kept in the source text form.",
      "prefill": "74700"
    },
    "account_following_count": {
      "type": "string",
      "title": "Following count",
      "description": "The account following count kept in the source text form.",
      "prefill": "260"
    },
    "account_heart_count": {
      "type": "string",
      "title": "Account heart count",
      "description": "The account heart count kept in the source text form."
    },
    "account_id": {
      "type": "string",
      "title": "Account ID",
      "description": "The numeric TikTok account ID returned with this video.",
      "prefill": "6905360269078922241"
    },
    "account_name": {
      "type": "string",
      "title": "Account name",
      "description": "The public display name of the account.",
      "prefill": "คณะสิงโตมังกรทองลูกชัยมงคล"
    },
    "account_secure_id": {
      "type": "string",
      "title": "Account secure ID",
      "description": "The source secure identifier of the account.",
      "prefill": "MS4wLjABAAAAB1kYoG7ow0_uy4aBS2ZdAH-tmY08IL85lod-zAzx5mh53zWaEyhH3_GzgFMubNuN"
    },
    "account_signature": {
      "type": "string",
      "title": "Account bio",
      "description": "The public account bio returned with this video.",
      "prefill": "ติดต่อสอบถามผลงาน"
    },
    "account_total_like_count": {
      "type": "string",
      "title": "Account like count",
      "description": "The account total like count kept in the source text form.",
      "prefill": "4401"
    },
    "author_create_time": {
      "type": "string",
      "title": "Account created at",
      "description": "The account creation timestamp in source form, without inferred timezone."
    },
    "biz_id": {
      "type": "string",
      "title": "Business ID",
      "description": "The source business identifier returned with this video.",
      "prefill": "https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399"
    },
    "clean_update_time": {
      "type": "string",
      "title": "Record update time",
      "description": "The source record update timestamp, without inferred timezone.",
      "prefill": "2026-08-26T12:58:28"
    },
    "collect_count": {
      "type": "string",
      "title": "Collect count",
      "description": "The public collect count kept in the source text form.",
      "prefill": "53"
    },
    "comment_count": {
      "type": "string",
      "title": "Comment count",
      "description": "The public comment count kept in the source text form.",
      "prefill": "10"
    },
    "content_id": {
      "type": "string",
      "title": "Video ID",
      "description": "The TikTok video ID that uniquely identifies this record.",
      "prefill": "7457124241389915399"
    },
    "content_text": {
      "type": "string",
      "title": "Video caption",
      "description": "The public caption text of the video.",
      "prefill": "#คณะสิงโตมังกรทองลูกชัยมงคล ซ้อมใหญ่เตรียมงานตรุษจีน #ลูกชัยมงคล #สิงโตโปงลาง #สิงโตอีเว้นท์ #เชิดสิงโตอวยพร #สิงโตมงคล"
    },
    "content_url": {
      "type": "string",
      "title": "Video URL",
      "description": "The public TikTok video URL.",
      "prefill": "https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399"
    },
    "country_code": {
      "type": "string",
      "title": "Country code",
      "description": "The source country code returned with this video.",
      "prefill": "TH"
    },
    "crawl_time": {
      "type": "string",
      "title": "Collected at",
      "description": "The collection timestamp in source form, without inferred timezone.",
      "prefill": "2026-08-26T12:58:27"
    },
    "cur_id": {
      "type": "string",
      "title": "Record ID",
      "description": "The source identifier of this collected detail record.",
      "prefill": "6a8e7274f5f83d2da3b12346"
    },
    "detailed_mentions": {
      "type": "string",
      "title": "Detailed mentions",
      "description": "The detailed mention text returned with this video."
    },
    "effect_stickers": {
      "type": "string",
      "title": "Effect stickers",
      "description": "The effect sticker text returned with this video."
    },
    "hashtags": {
      "type": "string",
      "title": "Hashtags",
      "description": "The hashtag text returned with this video."
    },
    "is_ad": {
      "type": "boolean",
      "title": "Paid ad",
      "description": "Whether the video is marked as a paid ad at collection time.",
      "prefill": false
    },
    "is_slideshow": {
      "type": "boolean",
      "title": "Slideshow",
      "description": "Whether the video is marked as a slideshow at collection time.",
      "prefill": false
    },
    "is_verified": {
      "type": "boolean",
      "title": "Verified account",
      "description": "Whether the account is marked verified at collection time.",
      "prefill": false
    },
    "keyword_list": {
      "type": "string",
      "title": "Submitted URL",
      "description": "The submitted TikTok URL associated with this result row.",
      "prefill": "https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399"
    },
    "like_count": {
      "type": "string",
      "title": "Like count",
      "description": "The public like count kept in the source text form.",
      "prefill": "652"
    },
    "location": {
      "type": "string",
      "title": "Location",
      "description": "The location text returned with this video."
    },
    "mentions": {
      "type": "string",
      "title": "Mentions",
      "description": "The mention text returned with this video."
    },
    "music_album": {
      "type": "string",
      "title": "Music album",
      "description": "The music album name returned with this video."
    },
    "music_author": {
      "type": "string",
      "title": "Music author",
      "description": "The music author name returned with this video."
    },
    "music_cover_url": {
      "type": "string",
      "title": "Music cover URL",
      "description": "The music cover image URL returned with this video."
    },
    "music_id": {
      "type": "string",
      "title": "Music ID",
      "description": "The music identifier returned with this video."
    },
    "music_name": {
      "type": "string",
      "title": "Music name",
      "description": "The music name returned with this video."
    },
    "music_original": {
      "type": "boolean",
      "title": "Original sound",
      "description": "Whether the sound is marked original at collection time.",
      "prefill": false
    },
    "music_original_cover_url": {
      "type": "string",
      "title": "Original sound cover",
      "description": "The original sound cover image URL returned with this video."
    },
    "music_play_url": {
      "type": "string",
      "title": "Music play URL",
      "description": "The music playback URL returned with this video."
    },
    "play_count": {
      "type": "string",
      "title": "Play count",
      "description": "The public play count kept in the source text form.",
      "prefill": "175600"
    },
    "private_account": {
      "type": "boolean",
      "title": "Private account",
      "description": "Whether the account is marked private at collection time.",
      "prefill": false
    },
    "profile_url": {
      "type": "string",
      "title": "Profile URL",
      "description": "The public account profile URL."
    },
    "publish_country": {
      "type": "string",
      "title": "Publish country",
      "description": "The publish country name returned with this video.",
      "prefill": "Thailand"
    },
    "publish_time": {
      "type": "string",
      "title": "Published at",
      "description": "The publish timestamp in source form, without inferred timezone.",
      "prefill": "2025-01-07T18:50:40"
    },
    "repost_count": {
      "type": "string",
      "title": "Repost count",
      "description": "The public repost count kept in the source text form."
    },
    "room_id": {
      "type": "string",
      "title": "Live room ID",
      "description": "The live room identifier returned with this video."
    },
    "share_count": {
      "type": "string",
      "title": "Share count",
      "description": "The public share count kept in the source text form.",
      "prefill": "28"
    },
    "subtitle_links": {
      "type": "string",
      "title": "Subtitle links",
      "description": "The subtitle link text returned with this video."
    },
    "task_item": {
      "type": "string",
      "title": "Requested item",
      "description": "The submitted item value that produced this result row.",
      "prefill": "https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399"
    },
    "task_no_data": {
      "type": "boolean",
      "title": "No data flag",
      "description": "Whether the source marked this submitted item as having no detail data.",
      "prefill": false
    },
    "text_language": {
      "type": "string",
      "title": "Caption language",
      "description": "The caption language returned with this video."
    },
    "tt_seller": {
      "type": "boolean",
      "title": "TikTok seller",
      "description": "Whether the account is marked as a TikTok seller at collection time.",
      "prefill": false
    },
    "user_friend_count": {
      "type": "string",
      "title": "Friend count",
      "description": "The account friend count kept in the source text form."
    },
    "user_video_count": {
      "type": "string",
      "title": "Account video count",
      "description": "The account video count kept in the source text form."
    },
    "video_cover_url": {
      "type": "string",
      "title": "Cover URL",
      "description": "The video cover image URL."
    },
    "video_definition": {
      "type": "string",
      "title": "Video definition",
      "description": "The video definition label returned with this video."
    },
    "video_download_addr": {
      "type": "string",
      "title": "Download URL",
      "description": "The video download URL returned with this video."
    },
    "video_duration": {
      "type": "integer",
      "title": "Duration seconds",
      "description": "The video duration in seconds.",
      "prefill": 0
    },
    "video_format": {
      "type": "string",
      "title": "Video format",
      "description": "The video format label returned with this video."
    },
    "video_height": {
      "type": "integer",
      "title": "Video height",
      "description": "The video height in pixels.",
      "prefill": 0
    },
    "video_original_cover_url": {
      "type": "string",
      "title": "Original video cover",
      "description": "The original video cover image URL returned with this video."
    },
    "video_urls": {
      "type": "string",
      "title": "Play URL",
      "description": "The video playback URL returned with this video.",
      "prefill": "https://v16-webapp-prime.us.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oYLDobO0QBjLEifIFQAByIED9AzofDhCRHfV0x/?a=1988&bti=ODszNWYuMDE6&&bt=1611&ft=4KJMyMzm8Zmo0Z.tHa4jV~CCQpWrKsd.&mime_type=video_mp4&rc=OjdoNTw5Omc1OWVmOzhoZUBpamU1d3I5cnJqdzMzODczNEAvNi9eYjVjNjQxNF8wYF8zYSM1LzJzMmRrYXJgLS1kMTFzcw%3D%3D&expire=1787893156&l=202608260458202CAFAB1344990A166E7B&ply_type=2&policy=2&signature=2080d8f77af89de133812156ebbabc98&tk=tt_chain_token&btag=e000c8000"
    },
    "video_width": {
      "type": "integer",
      "title": "Video width",
      "description": "The video width in pixels.",
      "prefill": 0
    }
  },
  "required": [],
  "additionalProperties": false
}

Integration

This App can be integrated via MCP, API, SDK, or file export. All channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API key (long-lived, created in the Data Hub Console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way.

With the MCP (Model Context Protocol), you can call this App directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.

Client config

Replace the value after Bearer with your long-lived API key. Works in any client, CI, or headless environment.

mcpServers config
{
  "mcpServers": {
    "hello_moto__tiktok-video-detail": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/tiktok-video-detail",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
View my API Keys →

Let AI set it up for you

Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client. It will complete the setup its own way. (The prompt asks the AI to request your API key from you, so credentials never end up in chat history or shared configs.)

detail.access.mcp.composeHint

Pricing

Task start

Charged once per submitted run, regardless of how many records are returned.

$0.0001/ run
Returned detail record

Charged by the number of records successfully returned. Failed runs are not charged.

$0.0015/ record

Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.

View credits

Try it now

Fill in the parameters and run. Results come from a real call.

Example
Parameters are validated against input.schema before submission
Please fill in the required parameters first
From $0.0015 / record