EN

TikTok Video Detail

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

Developer
Pricing
From $0.0015 / record
Last updated
2026-09-18

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 developer. 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.

  • TikTok video URLsvideo_itemsRequiredarray<object>
    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.
    Itemsup to 200 itemsExample[{"kw":"https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399"}]

Output

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

  • Account avatar URLaccount_avatar_urlstring
    The account avatar image URL returned for this video.
    Examplehttps://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
  • Follower countaccount_fans_countstring
    The account follower count kept in the source text form.
    Example74700
  • Following countaccount_following_countstring
    The account following count kept in the source text form.
    Example260
  • Account heart countaccount_heart_countstring
    The account heart count kept in the source text form.

Sample data

Generated from output.schema. Fields without a sample value use structural placeholders.

output.example
{
  "account_avatar_url": "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": "74700",
  "account_following_count": "260",
  "account_heart_count": "<account_heart_count>",
  "account_id": "6905360269078922241",
  "account_name": "คณะสิงโตมังกรทองลูกชัยมงคล",
  "account_secure_id": "MS4wLjABAAAAB1kYoG7ow0_uy4aBS2ZdAH-tmY08IL85lod-zAzx5mh53zWaEyhH3_GzgFMubNuN",
  "account_signature": "ติดต่อสอบถามผลงาน",
  "account_total_like_count": "4401",
  "author_create_time": "<author_create_time>",
  "biz_id": "https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399",
  "clean_update_time": "2026-08-26T12:58:28",
  "collect_count": "53",
  "comment_count": "10",
  "content_id": "7457124241389915399",
  "content_text": "#คณะสิงโตมังกรทองลูกชัยมงคล ซ้อมใหญ่เตรียมงานตรุษจีน #ลูกชัยมงคล #สิงโตโปงลาง #สิงโตอีเว้นท์ #เชิดสิงโตอวยพร #สิงโตมงคล",
  "content_url": "https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399",
  "country_code": "TH",
  "crawl_time": "2026-08-26T12:58:27",
  "cur_id": "6a8e7274f5f83d2da3b12346",
  "detailed_mentions": "<detailed_mentions>",
  "effect_stickers": "<effect_stickers>",
  "hashtags": "<hashtags>",
  "is_ad": false,
  "is_slideshow": false,
  "is_verified": false,
  "keyword_list": "https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399",
  "like_count": "652",
  "location": "<location>",
  "mentions": "<mentions>",
  "music_album": "<music_album>",
  "music_author": "<music_author>",
  "music_cover_url": "<music_cover_url>",
  "music_id": "<music_id>",
  "music_name": "<music_name>",
  "music_original": false,
  "music_original_cover_url": "<music_original_cover_url>",
  "music_play_url": "<music_play_url>",
  "play_count": "175600",
  "private_account": false,
  "profile_url": "<profile_url>",
  "publish_country": "Thailand",
  "publish_time": "2025-01-07T18:50:40",
  "repost_count": "<repost_count>",
  "room_id": "<room_id>",
  "share_count": "28",
  "subtitle_links": "<subtitle_links>",
  "task_item": "https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399",
  "task_no_data": false,
  "text_language": "<text_language>",
  "tt_seller": false,
  "user_friend_count": "<user_friend_count>",
  "user_video_count": "<user_video_count>",
  "video_cover_url": "<video_cover_url>",
  "video_definition": "<video_definition>",
  "video_download_addr": "<video_download_addr>",
  "video_duration": 0,
  "video_format": "<video_format>",
  "video_height": 0,
  "video_original_cover_url": "<video_original_cover_url>",
  "video_urls": "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": 0
}

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. This App runs asynchronously and can be canceled midway: After you cancel, the run stops. Records already delivered are kept and billed.

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": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/tiktok-video-detail",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

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. (By default it guides you through signing in, and never asks you to send your API key in the chat.)

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
From $0.0015 / record