TikTok Video Scraper

This actor extracts Videos in a List from TikTok. It captures video metadata, engagement statistics, author information, and music details from search results, user profiles, the For You Page, and Explore sections.

Data Fields

Field Name	Description	Example
Video Description	The text caption of the video	"Check out this recipe! #cooking"
Video Create Time	Timestamp when the video was posted	"2023-10-27T10:00:00Z"
Video Category Type	The classification of the video content	"Entertainment"
Video Duration	Length of the video in seconds	60
Video Width	Width of the video in pixels	1080
Video Height	Height of the video in pixels	1920
Video URL	Direct link to the TikTok video	"https://www.tiktok.com/@user/video/123"
Video Cover	URL of the video thumbnail image	"https://example.com/cover.jpg"
Video View Count	Total number of views	15000
Video Like Count	Total number of likes	1200
Video Comment Count	Total number of comments	45
Video Share Count	Total number of shares	30
Author ID	Unique identifier for the creator	"67890"
Author Nickname	Display name of the creator	"Chef John"
Author Username	Handle of the creator	"chefjohn123"
Author Avatar	URL of the author profile picture	"https://example.com/avatar.jpg"
Author Bio	The biography text of the author	"I love cooking and sharing recipes."
Author Verified	Boolean indicating if the account is verified	true
Music ID	Unique identifier for the audio track	"54321"
Music Title	Name of the song or sound	"Original Sound"
Music Author	Creator of the audio track	"Chef John"
Music Cover	URL of the music album art	"https://example.com/music.jpg"
Music URL	Link to the music page	"https://www.tiktok.com/music/id"
Music Duration	Length of the audio in seconds	60
Video Page URL	The URL of the page where the video was found	"https://www.tiktok.com/search?q=food"

Input

• urls: Array of TikTok URL strings. Supports search results, user profiles, For You Page, and Explore pages.
• maxItems: Maximum number of videos to extract per URL. Default is 100.

Example Input

{
  "urls": ["https://www.tiktok.com/search?q=tech"],
  "maxItems": 50
}

Example Output

[
  {
    "videoDescription": "New tech review!",
    "videoCreateTime": "2023-11-01T12:00:00Z",
    "videoCategoryType": "Tech",
    "videoDuration": 30,
    "videoWidth": 1080,
    "videoHeight": 1920,
    "videoUrl": "https://www.tiktok.com/@techguy/video/111",
    "videoCover": "https://example.com/c1.jpg",
    "videoViewCount": 5000,
    "videoLikeCount": 400,
    "videoCommentCount": 10,
    "videoShareCount": 5,
    "authorId": "101",
    "authorNickname": "Tech Guy",
    "authorUsername": "techguy",
    "authorAvatar": "https://example.com/a1.jpg",
    "authorBio": "Reviewing gadgets.",
    "authorVerified": false,
    "musicId": "m1",
    "musicTitle": "Tech Beat",
    "musicAuthor": "Producer X",
    "musicCover": "https://example.com/m1.jpg",
    "musicUrl": "https://www.tiktok.com/music/m1",
    "musicDuration": 30,
    "videoPageUrl": "https://www.tiktok.com/search?q=tech"
  },
  {
    "videoDescription": "Coding tips for beginners",
    "videoCreateTime": "2023-11-02T15:30:00Z",
    "videoCategoryType": "Education",
    "videoDuration": 45,
    "videoWidth": 1080,
    "videoHeight": 1920,
    "videoUrl": "https://www.tiktok.com/@coder/video/222",
    "videoCover": "https://example.com/c2.jpg",
    "videoViewCount": 8000,
    "videoLikeCount": 900,
    "videoCommentCount": 25,
    "videoShareCount": 15,
    "authorId": "202",
    "authorNickname": "Code Master",
    "authorUsername": "codemaster",
    "authorAvatar": "https://example.com/a2.jpg",
    "authorBio": "Learn to code.",
    "authorVerified": true,
    "musicId": "m2",
    "musicTitle": "Lofi Study",
    "musicAuthor": "Lofi Girl",
    "musicCover": "https://example.com/m2.jpg",
    "musicUrl": "https://www.tiktok.com/music/m2",
    "musicDuration": 45,
    "videoPageUrl": "https://www.tiktok.com/search?q=tech"
  }
]

Want more from TikTok?

This actor only covers Videos in a List. The full TikTok Scraper browser extension also includes Video Details, 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.