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
Source · en-USRevenir à la traduction
Aperçu
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.
Périmètre et limites
Each run accepts 1-200 TikTok video URLs; every valid deduplicated URL returns at most one publicly available detail record.
- Adapté pour
- 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
- À ne pas utiliser pour
- 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
Gestion des échecs
Comportement en cas d'échec et de nouvelle tentative déclaré par le développeur. Nous vous recommandons de l'inclure dans votre prompt système lors de l'intégration.
- 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
Entrée
Paramètres requis pour appeler cette App, générés à partir de l'input.schema du manifest.json.
- TikTok video URLs
video_itemsRequisarray<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.Nombrejusqu'à 200 élémentsExemple[{"kw":"https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399"}]
Sortie
Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.
- Account avatar URL
account_avatar_urlstringThe account avatar image URL returned for this video.Exemplehttps://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.Exemple74700 - Following count
account_following_countstringThe account following count kept in the source text form.Exemple260 - Account heart count
account_heart_countstringThe account heart count kept in the source text form.
Exemple de données
Généré à partir d'output.schema. Les champs sans valeur d'exemple utilisent des espaces réservés structurels.
{
"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
}Intégration
Cette App peut être intégrée via MCP, API, SDK ou export de fichiers — tous les canaux partagent les mêmes capacités et la même tarification. Chaque requête s'authentifie avec l'en-tête Authorization: Bearer à l'aide d'une API Key (longue durée, créée dans la console Data Hub) ; les clients MCP peuvent aussi se connecter via OAuth, sans clé. D'autres options comme la CLI et Skill arrivent bientôt. Cette App s'exécute de manière asynchrone et peut être annulée en cours de route : Après l'annulation, l'exécution s'arrête. Les enregistrements déjà livrés sont conservés et facturés.
Avec MCP (Model Context Protocol), vous pouvez appeler cette App directement depuis des clients IA comme Claude et Cursor. Choisissez votre client et votre mode d'authentification, puis copiez la config ci-dessous.
Config du client
Remplacez la valeur après Bearer par votre API Key longue durée. Fonctionne dans n'importe quel client, en CI ou en environnement sans navigateur.
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/tiktok-video-detail",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Laissez l'IA tout configurer pour vous
Vous ne voulez pas modifier les configs à la main ? Copiez le prompt d'installation et collez-le dans n'importe quel client IA — il effectuera la configuration à sa manière. (Par défaut, il vous guide pour vous connecter et ne vous demande jamais d'envoyer votre API Key dans la conversation.)
detail.access.mcp.composeHint
Tarifs
Facturé une fois par exécution soumise, quel que soit le nombre d'enregistrements renvoyés.
Facturé selon le nombre d'enregistrements renvoyés avec succès. Les exécutions échouées ne sont pas facturées.
Plusieurs événements de facturation se cumulent indépendamment. Voir chaque élément pour les détails. Les exécutions échouées ne sont pas facturées.
Voir les créditsEssayer maintenant
Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.