TikTok Video Details Scraper

This actor extracts Video Details from TikTok. It collects metadata from individual video pages including engagement metrics, author profiles, and music information. It is designed for deep data collection on specific video URLs.

Data Fields

Field Name	Description	Example
Video Description	The text content of the video post	Check out this amazing sunset! #nature
Video Create Time	Timestamp when the video was posted	2023-10-27T14:30:00Z
Video Category Type	The internal category classification	Entertainment
Video Duration	Length of the video in seconds	15
Video Width	Horizontal resolution in pixels	1080
Video Height	Vertical resolution in pixels	1920
Video URL	Direct link to the video file	https://v16m.tiktokcdn.com/video.mp4
Video Cover	URL of the video thumbnail image	https://p16.tiktokcdn.com/cover.jpg
Video View Count	Total number of views	150000
Video Like Count	Total number of likes	12000
Video Comment Count	Total number of comments	450
Video Share Count	Total number of shares	1200
Author ID	Unique identifier for the creator	6789012345
Author Nickname	Display name of the creator	Jane Doe
Author Username	Handle of the creator	janedoe_official
Author Avatar	URL of the creator profile picture	https://p16.tiktokcdn.com/avatar.jpg
Author Bio	The creator profile biography	Digital creator and traveler
Author Verified	Boolean indicating verification status	true
Music ID	Unique identifier for the audio track	123456789
Music Title	Name of the song or sound	Original Sound
Music Author	Creator of the audio track	janedoe_official
Music Cover	URL of the music album art	https://p16.tiktokcdn.com/music.jpg
Music URL	Link to the music page	https://www.tiktok.com/music/original-123
Music Duration	Length of the audio in seconds	60
Video Page URL	The original TikTok video link	https://www.tiktok.com/@user/video/12345

Input

• urls: Array of TikTok video URL strings. Only individual video pages are supported.
• maxItems: Maximum number of items to process per URL. Default is 100.

Example Input

{
  "urls": ["https://www.tiktok.com/@example/video/7123456789012345678"],
  "maxItems": 1
}

Example Output

[
  {
    "videoDescription": "Morning routine in NYC #vlog",
    "videoCreateTime": "2023-11-01T08:00:00Z",
    "videoCategoryType": "Lifestyle",
    "videoDuration": 30,
    "videoWidth": 1080,
    "videoHeight": 1920,
    "videoUrl": "https://v16m.tiktokcdn.com/v/1.mp4",
    "videoCover": "https://p16.tiktokcdn.com/obj/cover1.jpg",
    "videoViewCount": 50000,
    "videoLikeCount": 4500,
    "videoCommentCount": 120,
    "videoShareCount": 300,
    "authorId": "11223344",
    "authorNickname": "Alex Smith",
    "authorUsername": "alexsmith",
    "authorAvatar": "https://p16.tiktokcdn.com/obj/avatar1.jpg",
    "authorBio": "NYC Photographer",
    "authorVerified": false,
    "musicId": "998877",
    "musicTitle": "Lo-fi Beats",
    "musicAuthor": "LofiGirl",
    "musicCover": "https://p16.tiktokcdn.com/obj/music1.jpg",
    "musicUrl": "https://www.tiktok.com/music/lofi-998877",
    "musicDuration": 180,
    "videoPageUrl": "https://www.tiktok.com/@alexsmith/video/7123456789012345678"
  },
  {
    "videoDescription": "How to make the perfect pasta",
    "videoCreateTime": "2023-11-02T18:30:00Z",
    "videoCategoryType": "Food",
    "videoDuration": 60,
    "videoWidth": 1080,
    "videoHeight": 1920,
    "videoUrl": "https://v16m.tiktokcdn.com/v/2.mp4",
    "videoCover": "https://p16.tiktokcdn.com/obj/cover2.jpg",
    "videoViewCount": 1200000,
    "videoLikeCount": 95000,
    "videoCommentCount": 800,
    "videoShareCount": 15000,
    "authorId": "55667788",
    "authorNickname": "Chef Maria",
    "authorUsername": "mariacooks",
    "authorAvatar": "https://p16.tiktokcdn.com/obj/avatar2.jpg",
    "authorBio": "Professional Chef",
    "authorVerified": true,
    "musicId": "443322",
    "musicTitle": "Italian Dinner",
    "musicAuthor": "Classical Artist",
    "musicCover": "https://p16.tiktokcdn.com/obj/music2.jpg",
    "musicUrl": "https://www.tiktok.com/music/italian-443322",
    "musicDuration": 120,
    "videoPageUrl": "https://www.tiktok.com/@mariacooks/video/7890123456789012345"
  }
]

Want more from TikTok?

This actor only covers Video Details. The full TikTok Scraper browser extension also includes Videos in a List, Video Comments, User Profile, User Follows with unlimited personal use, real-time scraping with your logged-in sessions, CSV/Excel/JSON export, field customization, and scheduled monitoring.

Get the TikTok Scraper extension

Disclaimer: This tool extracts publicly available data. Users are responsible for compliance with applicable terms of service.