TikTok Video Extractor

This TikTok Video Scraper actor extracts comprehensive data from TikTok posts, including details like the post URL, author information (username, profile URL), video metadata (description, upload date, likes, comments, shares, views), hashtag usage, music information, and relevant associated text. This data is valuable for market research, trend analysis, sentiment analysis, competitor monitoring, identifying viral content, understanding audience engagement, and informing marketing strategies on the TikTok platform by providing actionable insights into content performance and user behavior.

Features

• Comprehensive Data Extraction: Scrapes all available information about TikTok posts, including video URL, likes, comments, shares, author details, captions, hashtags, and timestamps.
• Search by Hashtag and Keywords: Enables targeted data collection by specifying relevant hashtags or keywords, allowing users to focus on specific niches or trends.
• User Profile Scraping: Extracts posts from specific user profiles to monitor competitor activity, brand mentions, or influencer content.
• Content Analysis Ready: Outputs data in a structured format (e.g., CSV, JSON) ready for analysis, enabling users to identify trends, measure engagement, and understand audience preferences.
• Trend Identification and Early Adoption: Allows users to identify trending content and emerging hashtags, enabling timely responses and early adoption of viral trends.
• Competitor Analysis: Helps businesses monitor competitors' content strategy, identify successful posts, and understand their engagement levels.

Output Fields

Field Name	Type	Description
id	String	Unique identifier of the TikTok post.
author	Object	Object containing information about the post author (username, nickname, profile image URL, etc.).
author.username	String	TikTok username of the author.
author.nickname	String	Display name/nickname of the author.
author.profileImageUrl	String	URL of the author's profile picture.
author.userId	String	Unique identifier for the TikTok user.
video	Object	Object containing information about the video (id, description, URL, etc.).
video.id	String	Unique identifier of the video.
video.description	String	Description/caption of the video.
video.url	String	URL of the video.
video.downloadUrl	String	URL to download the video.
video.duration	Number	Duration of the video in seconds.
video.coverImageUrl	String	URL of the video's cover image/thumbnail.
music	Object	Object containing information about the music used in the video (id, title, author, URL, etc.).
music.id	String	Unique identifier of the music track.
music.title	String	Title of the music track.
music.author	String	Author/artist of the music track.
music.url	String	URL of the music track.
stats	Object	Object containing various statistics about the post (like count, comment count, share count, etc.).
stats.likeCount	Number	Number of likes the post has received.
stats.commentCount	Number	Number of comments the post has received.
stats.shareCount	Number	Number of times the post has been shared.
stats.viewCount	Number	Number of views the post has received.
createTime	Number	Unix timestamp (in seconds or milliseconds) representing when the post was created.
createTimeISO	String	ISO 8601 formatted date and time string representing when the post was created.
hashtags	Array	Array of strings representing the hashtags used in the video description.
mentions	Array	Array of strings representing the TikTok usernames mentioned in the video description.
stickers	Array	Array of objects representing the stickers used in the video (if any). Each object would contain sticker details (id, name, URL, etc.)
location	Object	Object containing location data associated with the post (if available).
location.latitude	Number	Latitude of the location.
location.longitude	Number	Longitude of the location.
location.name	String	Name of the location.
duetInfo	Object	Information about the duet status of the video (if it allows duet, etc.)
duetInfo.duetEnabled	Boolean	Indicates if the video allows for duets.
stitchInfo	Object	Information about the stitch status of the video (if it allows stitch, etc.)
stitchInfo.stitchEnabled	Boolean	Indicates if the video allows for stitches.
isAd	Boolean	Indicates if the post is an advertisement.
rawData	Object	The raw JSON data returned from the TikTok API for this post. Useful for debugging or accessing undocumented fields.

Possible Usage of the Actor

• Trend Identification and Predictive Analytics: Identify emerging trends, viral challenges, and popular sounds to inform marketing campaigns and product development. Predict future trends based on historical data to gain a competitive advantage.
• Competitor Analysis: Monitor competitor content performance (views, engagement, comments) to understand their strategies, audience targeting, and overall effectiveness. Benchmarking performance against competitors to identify areas for improvement.
• Influencer Marketing Optimization: Analyze influencer performance based on engagement rates, audience demographics, and content themes to identify the best influencers for specific campaigns and optimize influencer marketing ROI.
• Audience Segmentation and Targeting: Understand audience preferences, demographics, and behavior to create targeted advertising campaigns and personalized content experiences. Tailor messaging and content formats to specific audience segments for increased engagement.
• Brand Reputation Monitoring: Track mentions of a brand, sentiment analysis of comments, and identify potential PR crises. Proactively address negative feedback and manage brand reputation on the platform.
• Content Performance Optimization: Analyze the performance of different content types (videos, challenges, duets) to understand what resonates with the target audience and optimize future content creation. A/B testing different video elements (captions, hashtags, music) to maximize engagement.

Example Output

1{
2  "url": "https://www.tiktok.com/@marlenabeautydotcom/video/7213538148486368555?utm_campaign=tt4d_open_api&utm_source=awnuf8qyocl7mnug",
3  "post_id": "7213538148486368555",
4  "description": "The blue @herocosmetics pimple patches are my most favorite #pimplepatches #herocosmetics #clearskin ",
5  "create_time": "2023-03-23T00:52:21.000Z",
6  "digg_count": 83,
7  "share_count": "1",
8  "collect_count": 2,
9  "comment_count": 2,
10  "play_count": 7127,
11  "video_duration": 40,
12  "hashtags": [
13    "pimplepatches",
14    "herocosmetics",
15    "clearskin"
16  ],
17  "original_sound": "Marlena: original sound",
18  "profile_id": "6920267663675540485",
19  "profile_username": "Mar***a",
20  "profile_url": "https://www.tiktok.com/@marlenabeautydotcom",
21  "profile_avatar": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7352532892104261675~c5_1080x1080.jpeg?lk3s=a5d48078&nonce=47239&refresh_token=6eac95a2a2585d0386ca3515d035bdab&x-expires=1739059200&x-signature=EkD4jrZgBetvL6hpH1TRXwZvxgg%3D&shp=a5d48078&shcp=81f88b70",
22  "profile_biography": "you're safe here!!!! \ud83d\udc99",
23  "preview_image": "https://p19-sign.tiktokcdn-us.com/obj/tos-useast5-p-0068-tx/c9138c679796473899ac1499ee6916af?lk3s=81f88b70&x-expires=1739059200&x-signature=AhhIWtLBpVIaFTcYGjkJyQFlHD4%3D&shp=81f88b70&shcp=-",
24  "post_type": "video",
25  "discovery_input": null,
26  "offical_item": false,
27  "secu_id": "MS4wLjABAAAAGBhjq3urRAFRfg_0VgeeE3rC84OfjNV8FcMwOiUONZLhoUrqbqiIDz4tCfQvmgQP",
28  "original_item": false,
29  "shortcode": "7213538148486368555",
30  "width": 720,
31  "ratio": "720p",
32  "video_url": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/016136bcddcf4bbb81d54fa8da5797f5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&br=2154&bt=1077&cs=0&ds=3&ft=-Csk_mugPD12NJ9qsE-Ux9T2bY6e3wv25LcAp&mime_type=video_mp4&qs=0&rc=NzU7NjVkNDo5OWkzPDVnPEBpanh1ZjU6Zm10ajMzZzczNEAxNDQzMGM0XzAxLi0yMWBeYSM2by5rcjRfMGFgLS1kMS9zcw%3D%3D&btag=e00088000&expire=1739061179&l=20250207003218AEF4CACD81FD74DF5202&ply_type=2&policy=2&signature=496e209280d156b99a49eda080998e04&tk=tt_chain_token",
33  "music": {
34    "authorname": "Marlena",
35    "covermedium": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7352532892104261675~c5_720x720.jpeg?lk3s=a5d48078&nonce=84032&refresh_token=ac67938b8a532c720c8b1973bd5542f9&x-expires=1739059200&x-signature=TfzsTvTbi8Cz4y71%2FY0jf2SHN2s%3D&shp=a5d48078&shcp=81f88b70",
36    "id": "7213538166546893611",
37    "original": false,
38    "playurl": "https://v58.tiktokcdn.com/video/tos/maliva/tos-maliva-v-27dcd7c799-us/91675264c03144c9bfa5de0f543a116b/?a=1180&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ft=.NpOcInz7Th~Mk0OXq8Zmo&mime_type=audio_mpeg&qs=6&rc=ZTxkOGg3aTo4OjxoNzVnZEBpM2g1dzU6Zmt0ajMzZzU8NEAuLTY0Y2AvXl4xYjFhMC0tYSNrMi9qcjRvMmFgLS1kMS9zcw%3D%3D&vvpl=1&l=20250207003218AEF4CACD81FD74DF5202&VExpiration=1738974779&VSignature=6CM5ghcJR96rfrJEubuapw&btag=e00088000&cc=14",
39    "title": "original sound"
40  },
41  "cdn_url": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/016136bcddcf4bbb81d54fa8da5797f5/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&br=2154&bt=1077&cs=0&ds=3&ft=-Csk_mugPD12NJ9qsE-Ux9T2bY6e3wv25LcAp&mime_type=video_mp4&qs=0&rc=NzU7NjVkNDo5OWkzPDVnPEBpanh1ZjU6Zm10ajMzZzczNEAxNDQzMGM0XzAxLi0yMWBeYSM2by5rcjRfMGFgLS1kMS9zcw%3D%3D&btag=e00088000&expire=1739061179&l=20250207003218AEF4CACD81FD74DF5202&ply_type=2&policy=2&signature=496e209280d156b99a49eda080998e04&tk=tt_chain_token",
42  "is_verified": false,
43  "account_id": "marlenabeautydotcom",
44  "carousel_images": null,
45  "tagged_user": [
46    {
47      "user_handle": "herocosmetics",
48      "user_id": "6648687151347482630",
49      "user_name": "@herocosmetics",
50      "user_url": "https://www.tiktok.com/@herocosmetics"
51    }
52  ],
53  "profile_followers": 1471,
54  "tt_chain_token": "93rSimJl8jZqw3TekLAMWw==",
55  "region": "******",
56  "commerce_info": null
57}