🎬 TikTok Video Details Scraper Pro

Extract rich, structured, and actionable metadata from TikTok videos — fast, clean, and reliable.

TikTok Video Details Scraper Pro is a powerful Apify actor designed to extract comprehensive video, creator, music, engagement, and content metadata from one or multiple TikTok video URLs. It delivers clean, well-structured outputs suitable for analytics, research, monitoring, archiving, and automation workflows.

---

🚀 What This Actor Does

This actor allows you to submit one or more TikTok video URLs and receive a detailed metadata record for each video, including:

• 📹 Video details
• 👤 Creator profile information
• 🎵 Music & audio metadata
• 📊 Engagement statistics
• 🖼️ Thumbnails & covers
• 🌍 Location & region data
• ⚠️ Safety & content flags

All results are returned in a structured JSON format, ready for immediate use.

---

📥 Input Format

The actor accepts one or multiple TikTok video URLs.

✅ Input Example

{
    "startUrls": [
        {
            "url": "https://www.tiktok.com/@byarvelor/video/7567310800646458657",
            "method": "GET"
        },
        {
            "url": "https://www.tiktok.com/@byarvelor/video/7537409698685898016",
            "method": "GET"
        }
    ]
}

---

📤 Output Example

[
  {
    "Video URL": "https://www.tiktok.com/@byarvelor/video/7567310800646458657",
    "Video ID": "7567310800646458657",
    "Short URL / Share URL": "https://vm.tiktok.com/7567310800646458657/",
    "Video Caption / Description": "Luxury Lifestyle 💎 #luxurylifestyle #luxurycars #wealth #luxurylife ",
    "Caption Language": "en",
    "Hashtags": [
      "luxurylifestyle",
      "luxurycars",
      "wealth",
      "luxurylife"
    ],
    "Mentioned / Tagged Users": [],
    "Content Category": "N/A",
    "Video Duration": "00h, 00m, 15s",
    "Upload Date": "2025-10-31T09:11:31",
    "Upload Time": "09:11:31",
    "Unix Timestamp": 1761901891,
    "Video Resolution": "576x1024",
    "Video Aspect Ratio": "576:1024",
    "Video Orientation": "Portrait",
    "View Count": "24.5k",
    "Like Count": "1.9k",
    "Comment Count": "26",
    "Share Count": "102",
    "Save / Bookmark Count": "290",
    "Engagement Rate": "9.53%",
    "Trending Status": "false",
    "Music ID": "6937275716044131077",
    "Music Title": "i mean it",
    "Music Author / Artist Name": "𝙨𝙤𝙪𝙭𝙙𝙯.",
    "Original Sound Flag": true,
    "Music Duration": "00h, 00m, 53s",
    "Music Cover Image URL": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/0a033fbbc4660e1ae0d121c16aeaf0e7~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=81eb03e2&x-expires=1766908800&x-signature=hNaUBwZ7aoKp%2BGvfYfzeld92%2BCI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
    "Music Play URL": "https://v16m.tiktokcdn-us.com/f313e9bf7584c15797181743791317c8/694e9ae1/video/tos/useast5/tos-useast5-v-27dcd7-tx/74565be4ce5a4d468d7c36a58cbe466b/?a=1233&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=246&bt=123&ds=5&ft=GSDrKInz7ThctRSPXq8Zmo&mime_type=video_mp4&qs=13&rc=ang7bm5ueWQ1NDMzNzU8M0Bpang7bm5ueWQ1NDMzNzU8M0BfMi9tYHNnYzBgLS1iMTZzYSNfMi9tYHNnYzBgLS1iMTZzcw%3D%3D&vvpl=1&l=2025122608244433B4AAE92B918A00205C&btag=e00048000",
    "Audio Download URL": "https://v16m.tiktokcdn-us.com/f313e9bf7584c15797181743791317c8/694e9ae1/video/tos/useast5/tos-useast5-v-27dcd7-tx/74565be4ce5a4d468d7c36a58cbe466b/?a=1233&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=246&bt=123&ds=5&ft=GSDrKInz7ThctRSPXq8Zmo&mime_type=video_mp4&qs=13&rc=ang7bm5ueWQ1NDMzNzU8M0Bpang7bm5ueWQ1NDMzNzU8M0BfMi9tYHNnYzBgLS1iMTZzYSNfMi9tYHNnYzBgLS1iMTZzcw%3D%3D&vvpl=1&l=2025122608244433B4AAE92B918A00205C&btag=e00048000",
    "Creator User ID": "7475138907791983618",
    "Creator Username": "@byarvelor",
    "Creator Profile URL": "https://www.tiktok.com/@byarvelor",
    "Creator Profile Picture URL": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/6f15b490328ee82d983d9c3ca39e6f71~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=8f4d4323&x-expires=1766908800&x-signature=sdQ0qRcTjnPKnu7bKWHAE8QDORs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
    "Creator Bio": "✧ Luxury | Success | Mindset ✧\n⇓\nBuilt to Help You Grow Online\n⇘ ⇙",
    "Creator Verified Badge": false,
    "Creator Follower Count": "130.4k",
    "Creator Following Count": "19",
    "Creator Total Likes": "2.3m",
    "Creator Total Videos": "300",
    "Video File Size": "4.20 MB",
    "Video Format": "mp4",
    "Video Codec": "h265_hvc1",
    "Video Bitrate": "2342964",
    "Video FPS": "N/A",
    "Video Download URL": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/o0KqWIpIPxQsCFUSA0gIjfKL1egrEnIMGGeDgm/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2910&bt=1455&cs=0&ds=3&ft=4KJMyMzm8Zmo0Eklrx4jVLPldpWrKsd.&mime_type=video_mp4&qs=0&rc=Ojw6ZmdpaWRpZjdlOjQ1NkBpamVkamw5cmg6NzMzZjczNUAzM15jMWBeXl8xM2FgL19iYSM0Z2lqMmQ0bi9hLS1kMTNzcw%3D%3D&btag=e000b8000&expire=1766910299&l=2025122608244433B4AAE92B918A00205C&ply_type=2&policy=2&signature=9d63d1459392f074e35d1e284b656cdc&tk=tt_chain_token",
    "Thumbnail Image URL": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/oIp0KAeKMCgO8ejgIxgqgmLI9l9s8SRoGUGPDf~tplv-tiktokx-origin.image?dr=9636&x-expires=1766908800&x-signature=4uvZAxER5MlYaepPjMVd9A1r2Kw%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
    "Cover Image URL": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/ogGK5SPD0mpIIBLjJsQCETAMqfgeexKIzACQUG~tplv-tiktokx-origin.image?dr=9636&x-expires=1766908800&x-signature=WsM7ImoJ8kzSlkVl8AYiVsL4I1o%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
    "Animated Cover URL": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/ocPIKCDw0LmeADMPqSKxjdgkpIQLeGsGQIfURi~tplv-tiktokx-origin.image?dr=9636&x-expires=1766908800&x-signature=bsBlGyVNPZAJjRDONSHFMPnUEdc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
    "Location & Meta": "N/A",
    "Video Region / Country": "PT",
    "Language Code": "N/A",
    "Device Type": "web",
    "App Version": "N/A",
    "Pinned Comment Flag": "N/A",
    "Is Duet Enabled": true,
    "Is Stitch Enabled": true,
    "Duet Source Video ID": "N/A",
    "Stitch Source Video ID": "N/A",
    "Remix Permission Flag": "true",
    "Video Transcript (Speech-to-Text)": "N/A",
    "Spoken Language Detection": "N/A",
    "On-screen Text (OCR)": "N/A",
    "Sentiment Analysis Result": "N/A (Requires external AI)",
    "Topic / Keyword Extraction": "N/A",
    "NSFW / Content Flag": false,
    "AI Caption Summary": "N/A",
    "Create Time (epoch)": 1761901891,
    "Update Time": "N/A",
    "Content Risk Flag": "false",
    "Ad / Sponsored Flag": false,
    "Copyright / Music Restriction Flag": "false"
  },
  {
    "Video URL": "https://www.tiktok.com/@byarvelor/video/7537409698685898016",
    "Video ID": "7537409698685898016",
    "Short URL / Share URL": "https://vm.tiktok.com/7537409698685898016/",
    "Video Caption / Description": "Luxury Lifestyle 💎 #luxurylife #wealth #millionaire #luxurycars ",
    "Caption Language": "en",
    "Hashtags": [
      "luxurylife",
      "wealth",
      "millionaire",
      "luxurycars"
    ],
    "Mentioned / Tagged Users": [],
    "Content Category": "N/A",
    "Video Duration": "00h, 00m, 08s",
    "Upload Date": "2025-08-11T19:19:36",
    "Upload Time": "19:19:36",
    "Unix Timestamp": 1754939976,
    "Video Resolution": "576x1024",
    "Video Aspect Ratio": "576:1024",
    "Video Orientation": "Portrait",
    "View Count": "1.8m",
    "Like Count": "176.5k",
    "Comment Count": "785",
    "Share Count": "17.2k",
    "Save / Bookmark Count": "25.4k",
    "Engagement Rate": "12.22%",
    "Trending Status": "true",
    "Music ID": "7455337249652771585",
    "Music Title": "original sound",
    "Music Author / Artist Name": "ChainShadow",
    "Original Sound Flag": true,
    "Music Duration": "00h, 00m, 28s",
    "Music Cover Image URL": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/b99c320b10a985687d5b8fba8f7b248a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=d95cf8cc&x-expires=1766908800&x-signature=FSAnqgyj5lwO7hMYN9gqe%2Bm1QN4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
    "Music Play URL": "https://v16m.tiktokcdn-us.com/d63de57e5f379ac5689623b4cc357e40/694e9ac8/video/tos/useast5/tos-useast5-ve-27dcd7c799-tx/o8UBHpBiU2YJAE3slMvlb2ttU3hrIAGiCiZaN/?a=1233&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ft=GSDrKInz7ThctRSPXq8Zmo&mime_type=audio_mpeg&qs=6&rc=NzlkODVlZTpkMzs0OTU4OkBpMzVqb3E5cmdkdzMzODU8NEAxMV8wYzU2Ni0xXmBeNF4vYSNvYS8tMmRrb29gLS1kMS1zcw%3D%3D&vvpl=1&l=2025122608244499915BE42C348C002149&btag=e000b8000",
    "Audio Download URL": "https://v16m.tiktokcdn-us.com/d63de57e5f379ac5689623b4cc357e40/694e9ac8/video/tos/useast5/tos-useast5-ve-27dcd7c799-tx/o8UBHpBiU2YJAE3slMvlb2ttU3hrIAGiCiZaN/?a=1233&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ft=GSDrKInz7ThctRSPXq8Zmo&mime_type=audio_mpeg&qs=6&rc=NzlkODVlZTpkMzs0OTU4OkBpMzVqb3E5cmdkdzMzODU8NEAxMV8wYzU2Ni0xXmBeNF4vYSNvYS8tMmRrb29gLS1kMS1zcw%3D%3D&vvpl=1&l=2025122608244499915BE42C348C002149&btag=e000b8000",
    "Creator User ID": "7475138907791983618",
    "Creator Username": "@byarvelor",
    "Creator Profile URL": "https://www.tiktok.com/@byarvelor",
    "Creator Profile Picture URL": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/6f15b490328ee82d983d9c3ca39e6f71~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=8f4d4323&x-expires=1766908800&x-signature=sdQ0qRcTjnPKnu7bKWHAE8QDORs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
    "Creator Bio": "✧ Luxury | Success | Mindset ✧\n⇓\nBuilt to Help You Grow Online\n⇘ ⇙",
    "Creator Verified Badge": false,
    "Creator Follower Count": "130.4k",
    "Creator Following Count": "19",
    "Creator Total Likes": "2.3m",
    "Creator Total Videos": "300",
    "Video File Size": "1.74 MB",
    "Video Format": "mp4",
    "Video Codec": "h265_hvc1",
    "Video Bitrate": "1782070",
    "Video FPS": "N/A",
    "Video Download URL": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/ocEikQaCZQ2B0u0ih8ISgIvJBAa9iKBOQzZpE/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2566&bt=1283&cs=0&ds=3&ft=4KJMyMzm8Zmo0Eklrx4jVI2bdpWrKsd.&mime_type=video_mp4&qs=0&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmNmc3ZGQ4PDtnZjo1Z2VlZkBpM3BqO205cmQ3NTMzZjczNUBjRl5Nc3FePmJKYSNvYF90aHFmOiNgL182YjEyNjQxMzEvMTJgYSNuZWtrMmRrMWFhLS1kMTNzcw%3D%3D&btag=e000b0000&expire=1766910292&l=2025122608244499915BE42C348C002149&ply_type=2&policy=2&signature=06aaa15a4efa8c2a02cfae8a11c471ae&tk=tt_chain_token",
    "Thumbnail Image URL": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/okB0IDIkgzaiizDpQBuQ2yAZipavBK08CiJIE~tplv-tiktokx-origin.image?dr=9636&x-expires=1766908800&x-signature=9dPaU4%2FSWngqLACjVt%2BhBIT7a1M%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
    "Cover Image URL": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/ogJIr80AEiazB2iIC0BipIkpQgK0ZuvQiAa1J~tplv-tiktokx-origin.image?dr=9636&x-expires=1766908800&x-signature=F1XaWi3ElU1qcyjhuIXGjemgShc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
    "Animated Cover URL": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/osgBaAIpZJuiakKBC0Qy8z0HIvSEaBIn2ixpi~tplv-tiktokx-origin.image?dr=9636&x-expires=1766908800&x-signature=i5S9pGJw4NAoHPS2tgWChTsO8Jc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
    "Location & Meta": "N/A",
    "Video Region / Country": "PT",
    "Language Code": "N/A",
    "Device Type": "mobile",
    "App Version": "N/A",
    "Pinned Comment Flag": "N/A",
    "Is Duet Enabled": true,
    "Is Stitch Enabled": true,
    "Duet Source Video ID": "N/A",
    "Stitch Source Video ID": "N/A",
    "Remix Permission Flag": "true",
    "Video Transcript (Speech-to-Text)": "https://v16m-webapp.tiktokcdn-us.com/43cc313ea31ef7f2cd084c18adb04ec9/6950e954/video/tos/useast2a/tos-useast2a-v-0037-euttp/70abc3e42ef246cba56541d8e91b717e/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=21132&bt=10566&cs=0&ds=4&ft=4KLMeMzm8Zmo0Eklrx4jVI2bdpWrKsd.&mime_type=video_mp4&qs=13&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmM3BqO205cmQ3NTMzZjczNUBpM3BqO205cmQ3NTMzZjczNUBjRl5Nc3FePmJKYSNvYF90aHFmOiNuZWtrMmRrMWFhLS1kMTNzYSNuZWtrMmRrMWFhLS1kMTNzcw%3D%3D&l=2025122608244499915BE42C348C002149&btag=e00070000",
    "Spoken Language Detection": "N/A",
    "On-screen Text (OCR)": "N/A",
    "Sentiment Analysis Result": "N/A (Requires external AI)",
    "Topic / Keyword Extraction": "N/A",
    "NSFW / Content Flag": false,
    "AI Caption Summary": "N/A",
    "Create Time (epoch)": 1754939976,
    "Update Time": "N/A",
    "Content Risk Flag": "false",
    "Ad / Sponsored Flag": false,
    "Copyright / Music Restriction Flag": "false"
  }
]

• ✅ If the creator has kept any data private, it should show as N/A. If the data is public, it should be scraped automatically.

📦 Data This Actor Provides

The actor extracts four major categories of data:

1️⃣ Video Information

2️⃣ Engagement & Performance Metrics

3️⃣ Music & Audio Details

4️⃣ Creator (Author) Profile Data

Plus several advanced flags and metadata fields for content analysis.

---

📤 Output Fields & Explanations

Below is a complete explanation of every output field returned by the actor.

---

🎥 Video Identification & URLs

Field	Description
Video URL	Canonical TikTok video URL
Video ID	Unique TikTok video identifier
Short URL / Share URL	Shareable short link
Video Caption / Description	Full caption text
Caption Language	Detected caption language
Hashtags	All hashtags used in caption
Mentioned / Tagged Users	Tagged usernames
Content Category	Content classification (if available)

---

⏱️ Time & Publishing Info

Field	Description
Upload Date	Video upload date (ISO format)
Upload Time	Upload time
Unix Timestamp	Epoch timestamp
Create Time (epoch)	Raw creation timestamp

---

📐 Video Technical Details

Field	Description
Video Duration	Video length (HH:MM:SS)
Video Resolution	Width × Height
Video Aspect Ratio	Aspect ratio
Video Orientation	Portrait / Landscape
Video Format	Video format (e.g., mp4)
Video Codec	Encoding type
Video Bitrate	Video bitrate
Video FPS	Frames per second
Video File Size	Approximate file size

---

📊 Engagement & Performance Metrics

Field	Description
View Count	Total views
Like Count	Total likes
Comment Count	Total comments
Share Count	Total shares
Save / Bookmark Count	Total saves
Engagement Rate	Engagement percentage
Trending Status	High-performance indicator

---

🎵 Music & Audio Metadata

Field	Description
Music ID	Unique music identifier
Music Title	Track title
Music Author / Artist Name	Artist name
Original Sound Flag	Original or reused sound
Music Duration	Audio length
Music Cover Image URL	Music artwork
Music Play URL	Audio playback URL
Audio Download URL	Direct audio source

---

👤 Creator (Author) Information

Field	Description
Creator User ID	Unique creator ID
Creator Username	TikTok username
Creator Profile URL	Profile link
Creator Profile Picture URL	Avatar image
Creator Bio	Profile bio
Creator Verified Badge	Verification status
Creator Follower Count	Followers
Creator Following Count	Following
Creator Total Likes	Total likes
Creator Total Videos	Uploaded videos

---

🖼️ Thumbnails & Visual Assets

Field	Description
Thumbnail Image URL	Standard thumbnail
Cover Image URL	Original cover image
Animated Cover URL	Animated thumbnail

---

🌍 Location & Regional Metadata

Field	Description
Location & Meta	POI / location info
Video Region / Country	Origin country
Language Code	Language metadata
Device Type	Mobile / Web
App Version	App version (if available)

---

🔐 Content Flags & Permissions

Field	Description
Is Duet Enabled	Duet allowed
Is Stitch Enabled	Stitch allowed
Duet Source Video ID	Original duet source
Stitch Source Video ID	Original stitch source
Remix Permission Flag	Remix allowed
Pinned Comment Flag	Pinned comment indicator
NSFW / Content Flag	Safety indicator
Ad / Sponsored Flag	Sponsored content
Content Risk Flag	Risk assessment
Copyright / Music Restriction Flag	Music restrictions

---

🧠 Advanced & AI-Ready Fields

Field	Description
Video Transcript (Speech-to-Text)	Subtitle / transcript URL
Spoken Language Detection	Detected speech language
On-screen Text (OCR)	On-screen text
Sentiment Analysis Result	Placeholder
Topic / Keyword Extraction	Placeholder
AI Caption Summary	Placeholder

⚠️ Some advanced fields are intentionally marked as "N/A" for compatibility with downstream AI or enrichment workflows.

---

---

🌟 Benefits & Advantages

• ✅ Extract dozens of fields in one run
• ✅ Clean, structured & ready-to-use output
• ✅ Supports multiple URLs at once
• ✅ Ideal for analytics & monitoring
• ✅ Marketplace-ready & automation-friendly
• ✅ No manual work required

---

🧠 Best Practices

• ✔️ Always use valid public TikTok video URLs
• ✔️ Provide multiple URLs for batch processing
• ✔️ Use outputs for analytics, dashboards, or storage
• ✔️ Expect "N/A" values for unavailable fields
• ✔️ Ideal for research, archiving, and reporting

---

⚠️ Common Errors & How to Avoid Them

Issue	Solution
No output returned	Ensure URLs are valid
Some fields show "N/A"	Data not publicly available
Empty dataset	Double-check input format
Partial results	Try re-running with fewer URLs

---

🧩 Use Cases

• 📊 TikTok performance analysis
• 📁 Video metadata archiving
• 📈 Influencer research
• 🔍 Content moderation workflows
• 🤖 AI data enrichment pipelines

---

📩 Support & Contact

If you need help, custom features, or support:

📧 Email: alphascraper69@gmail.com

---

🏁 Final Notes

TikTok Video Details Scraper Pro is built for accuracy, clarity, and scalability — delivering professional-grade metadata with minimal effort.

⭐ If you find this actor useful, consider starring or sharing it!

---