TikTok Video Search Scraper 🎥

Features ✨

• 🔍 Search and scrape TikTok videos by keywords
• 📊 Extract comprehensive video metadata and statistics
• 👤 Get detailed creator information
• #️⃣ Capture hashtag data and engagement metrics
• 🚀 High-performance scraping with built-in stealth mode
• ⚡ Support for concurrent searches
• 🎯 Customizable result limits

Description 📝

This actor allows you to scrape detailed information about TikTok videos based on search keywords. It navigates through TikTok's search results and extracts comprehensive data about each video, including engagement metrics, creator details, and associated hashtags.

Input Parameters 📋

The actor accepts the following input parameters:

• keywords (Array): List of search terms to scrape videos for
• maxItems (Integer): Maximum number of items to scrape

Output Format 📤

The actor outputs detailed JSON data for each video, including:

• Video metadata (ID, description, creation time, duration)
• Video statistics (views, likes, shares, comments)
• Author information (ID, nickname, follower count)
• Music details
• Hashtag information
• Engagement metrics

Use Cases 🎯

• Social media research and analysis
• Influencer marketing research
• Content trend analysis
• Engagement metrics tracking
• Hashtag performance monitoring

Tips 💡

• Use specific keywords for more targeted results
• Adjust maxItems based on your needs
• Consider running multiple searches with different keywords for broader coverage

Need help or have questions? Feel free to reach out through Apify's platform!

Input Example

A full explanation of an input example in JSON.

1{
2	"keywords": [
3        "ronaldo"
4    ],
5    "maxItems": 20
6}

Output sample

The results will be wrapped into a dataset which you can always find in the Storage tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

1[
2	{
3		"id": "7430861519539244321",
4		"desc": "#ronaldo #cristianoronaldo ",
5		"createTime": 1730132278,
6		"video": {
7			"id": "7430861519539244321",
8			"height": 742,
9			"width": 576,
10			"duration": 81,
11			"ratio": "540p",
12			"cover": "https://p16-sign-useast2a.tiktokcdn.com/obj/tos-useast2a-p-0037-euttp/60636fca34414c0c879ac4a774ccf676_1730132282?lk3s=b59d6b55&x-expires=1730383200&x-signature=SD%2F2n0BOMwYukgKCaIalDTLkobE%3D&shp=b59d6b55&shcp=-",
13			"originCover": "https://p16-sign-useast2a.tiktokcdn.com/obj/tos-useast2a-p-0037-euttp/c6f08555b4184fa881b6147424a28e9c_1730132281?lk3s=b59d6b55&x-expires=1730383200&x-signature=JC2ndPppi6kxaBz5oIcf2WlzNHE%3D&shp=b59d6b55&shcp=-",
14			"dynamicCover": "https://p16-sign-useast2a.tiktokcdn.com/obj/tos-useast2a-p-0037-euttp/7abb9c20786549959fd02618f23fb4b0_1730132282?lk3s=b59d6b55&x-expires=1730383200&x-signature=MuFU05c1cuvtfzDsu5cxqRmtYbo%3D&shp=b59d6b55&shcp=-",
15			"playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/oMPAoEI3VhGmjdgzGyfsLsfGejeAoORIuhg1tI/?a=1988&bti=NDU3ZjAwOg%3D%3D&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=1954&bt=977&cs=0&ds=6&ft=4KJMyMUm8Zmo0WVItb4jV8tbdpWrKsd.&mime_type=video_mp4&qs=0&rc=PGc1ZWg5OzU2Mzk4Mzo7ZkBpM2Y0ZHI5cnB1djMzZjczM0BhYjE1Mi9fXjIxNjE2MzItYSNxam9yMmRrZWNgLS1kMWNzcw%3D%3D&btag=e00090000&expire=1730386529&l=20241029145408E1669EB1624A500B8E1C&ply_type=2&policy=2&signature=e16e8bff796d56ca853d9cefc5d5cc62&tk=tt_chain_token",
16			"shareCover": [
17				"",
18				"https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/c6f08555b4184fa881b6147424a28e9c_1730132281~tplv-photomode-tiktok-play.jpeg?lk3s=b59d6b55&x-expires=1730815200&x-signature=Cj315uuhD6oOxYfcVwcVW7l4SfI%3D&shp=b59d6b55&shcp=-",
19				"https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/c6f08555b4184fa881b6147424a28e9c_1730132281~tplv-photomode-share-play.jpeg?lk3s=b59d6b55&x-expires=1730815200&x-signature=11xq%2BDyBonIYtzivw4hojQBY3m4%3D&shp=b59d6b55&shcp=-"
20			],
21			"reflowCover": "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/60636fca34414c0c879ac4a774ccf676_1730132282~tplv-photomode-video-cover:480:480.jpeg?lk3s=b59d6b55&x-expires=1730383200&x-signature=twqKT9s%2BxPBvj3AAlUx2Vps1Do0%3D&shp=b59d6b55&shcp=-",
22			"bitrate": 1000752,
23			"encodedType": "normal",
24			"format": "mp4",
25			"videoQuality": "normal",
26			"encodeUserTag": ""
27		},
28		"author": {
29			"id": "6975839703509959686",
30			"uniqueId": "fullycronaldo",
31			"nickname": "FullyRonaldo",
32			"avatarThumb": "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4f11a940c0b55b53d293e4b374c5eed2~c5_100x100.jpeg?lk3s=a5d48078&nonce=82730&refresh_token=ad1bbef02ee631ed963cf2fd51ae1b24&x-expires=1730383200&x-signature=dAq62unLkVtu0q5LQt0%2FqPhlTQM%3D&shp=a5d48078&shcp=b59d6b55",
33			"avatarMedium": "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4f11a940c0b55b53d293e4b374c5eed2~c5_720x720.jpeg?lk3s=a5d48078&nonce=23808&refresh_token=d663584fa831cad489402472db6dd14f&x-expires=1730383200&x-signature=WabyNUmJPD7lvDauRRswUlgkf4U%3D&shp=a5d48078&shcp=b59d6b55",
34			"avatarLarger": "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4f11a940c0b55b53d293e4b374c5eed2~c5_1080x1080.jpeg?lk3s=a5d48078&nonce=45709&refresh_token=4ddbf575033b432cfef60e1ecf4ca046&x-expires=1730383200&x-signature=LKhsD2VVy0DPIcetH1OXINEh%2B0M%3D&shp=a5d48078&shcp=b59d6b55",
35			"signature": "Calma only a matter of time
God first",
36			"verified": false,
37			"secUid": "MS4wLjABAAAAoUjcp9S4sr0nC9G6FbMLluW0J0YUHYHkt7boeE_xlVRGIgdEw3RHquChQK-iIyy2",
38			"secret": false,
39			"ftc": false,
40			"relation": 0,
41			"openFavorite": false,
42			"commentSetting": 0,
43			"duetSetting": 0,
44			"stitchSetting": 0,
45			"privateAccount": false,
46			"downloadSetting": 3
47		},
48		"music": {
49			"id": "7430861584232975136",
50			"title": "original sound",
51			"playUrl": "",
52			"coverThumb": "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4f11a940c0b55b53d293e4b374c5eed2~c5_100x100.jpeg?lk3s=a5d48078&nonce=82730&refresh_token=ad1bbef02ee631ed963cf2fd51ae1b24&x-expires=1730383200&x-signature=dAq62unLkVtu0q5LQt0%2FqPhlTQM%3D&shp=a5d48078&shcp=b59d6b55",
53			"coverMedium": "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4f11a940c0b55b53d293e4b374c5eed2~c5_720x720.jpeg?lk3s=a5d48078&nonce=23808&refresh_token=d663584fa831cad489402472db6dd14f&x-expires=1730383200&x-signature=WabyNUmJPD7lvDauRRswUlgkf4U%3D&shp=a5d48078&shcp=b59d6b55",
54			"coverLarge": "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-avt-0068-euttp/4f11a940c0b55b53d293e4b374c5eed2~c5_1080x1080.jpeg?lk3s=a5d48078&nonce=45709&refresh_token=4ddbf575033b432cfef60e1ecf4ca046&x-expires=1730383200&x-signature=LKhsD2VVy0DPIcetH1OXINEh%2B0M%3D&shp=a5d48078&shcp=b59d6b55",
55			"authorName": "FullyRonaldo",
56			"original": true,
57			"duration": 81,
58			"album": ""
59		},
60		"challenges": [
61			{
62				"id": "70501",
63				"title": "ronaldo",
64				"desc": "",
65				"profileThumb": "",
66				"profileMedium": "",
67				"profileLarger": "",
68				"coverThumb": "",
69				"coverMedium": "",
70				"coverLarger": "",
71				"isCommerce": false
72			},
73			{
74				"id": "20374",
75				"title": "cristianoronaldo",
76				"desc": "",
77				"profileThumb": "",
78				"profileMedium": "",
79				"profileLarger": "",
80				"coverThumb": "",
81				"coverMedium": "",
82				"coverLarger": "",
83				"isCommerce": false
84			}
85		],
86		"stats": {
87			"diggCount": 206900,
88			"shareCount": 15500,
89			"commentCount": 2189,
90			"playCount": 1300000,
91			"collectCount": 23700
92		},
93		"duetInfo": {
94			"duetFromId": "0"
95		},
96		"originalItem": false,
97		"officalItem": false,
98		"textExtra": [
99			{
100				"awemeId": "",
101				"start": 0,
102				"end": 8,
103				"hashtagName": "ronaldo",
104				"hashtagId": "70501",
105				"type": 1,
106				"userId": "",
107				"isCommerce": false,
108				"userUniqueId": "",
109				"secUid": "",
110				"subType": 0
111			},
112			{
113				"awemeId": "",
114				"start": 9,
115				"end": 26,
116				"hashtagName": "cristianoronaldo",
117				"hashtagId": "20374",
118				"type": 1,
119				"userId": "",
120				"isCommerce": false,
121				"userUniqueId": "",
122				"secUid": "",
123				"subType": 0
124			}
125		],
126		"secret": false,
127		"forFriend": false,
128		"digged": false,
129		"itemCommentStatus": 0,
130		"showNotPass": false,
131		"vl1": false,
132		"itemMute": false,
133		"authorStats": {
134			"followingCount": 107,
135			"followerCount": 350200,
136			"heartCount": 52700000,
137			"videoCount": 410,
138			"diggCount": 44800,
139			"heart": 52700000
140		},
141		"privateItem": false,
142		"duetEnabled": true,
143		"stitchEnabled": true,
144		"shareEnabled": true,
145		"stickersOnItem": [
146			{
147				"stickerType": 4,
148				"stickerText": [
149					"Cristiano Ronaldo always was right."
150				]
151			}
152		],
153		"isAd": false,
154		"collected": false
155	},
156    ...
157]