Submit a TikTok username and retrieve its collected video records after the collection task finishes
TikTok Video Detail
Submit up to 200 TikTok video URLs and retrieve public video, account, engagement, and media details
原文 · en-US訳文に戻す
概要
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 ID | Account name | Play count | Like count | Publish country | Verified account |
|---|---|---|---|---|---|
| 7457124241389915399 | คณะสิงโตมังกรทองลูกชัยมงคล | 175600 | 652 | Thailand | No |
| 7659102246143102238 | Luxury cars | 6532 | 118 | United States | No |
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.
適用範囲と境界
Each run accepts 1-200 TikTok video URLs; every valid deduplicated URL returns at most one publicly available detail record.
- 適している用途
- 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 to discover videos by keyword, hashtag, or account; supply known TikTok video URLs
- Do not use for private, deleted, or login-only videos
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1Retry temporary task or service failures with the same video URLs
- 2If only part of the task succeeds, use the returned records and retry the missing video URLs
- 3An empty result can mean that a URL is invalid, duplicated, unavailable, or no longer public
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
- TikTok video URLs
video_items必須array<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.件数最大 200 件例[{"kw":"https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399"}]
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- Account avatar URL
account_avatar_urlstringThe account avatar image URL returned for this video.例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 - Follower count
account_fans_countstringThe account follower count kept in the source text form.例74700 - Following count
account_following_countstringThe account following count kept in the source text form.例260 - Account heart count
account_heart_countstringThe account heart count kept in the source text form.
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"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
}連携方法
この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。 この App は非同期で実行され、途中でキャンセルできます:キャンセル後、実行は停止します。納品済みのレコードは保持され、課金対象になります。
MCP(Model Context Protocol)を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。
クライアント設定
Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/tiktok-video-detail",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(デフォルトではログインを案内し、API Key をチャットに送るよう求めることはありません)。
detail.access.mcp.composeHint
料金
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。