TikTok Search Results Scraper avatar

TikTok Search Results Scraper

Pricing

from $1.60 / 1,000 videos

Go to Apify Store
TikTok Search Results Scraper

TikTok Search Results Scraper

Search public TikTok videos or creator profiles by keyword. Save captions, hashtags, engagement counts, profile details, media links, music, subtitles, and the first search value for each row.

Pricing

from $1.60 / 1,000 videos

Rating

0.0

(0)

Developer

Maxime Dupré

Maxime Dupré

Maintained by Community

Actor stats

0

Bookmarked

12

Total users

4

Monthly active users

18 days ago

Last modified

Features

Limited permissions

Share

🔎 TikTok search for videos and creators

For social media researchers, marketers, and content teams, this Actor searches TikTok's public video or creator results by keyword. It saves captions, hashtags, engagement counts, creator details, media links, music, subtitles, and the first search value for each row, so you can review public search data in a dataset without a TikTok login or source credential.

📊 TikTok results you can save

The dataset has two row types. Video rows include the post, caption, hashtags, public engagement counts, creator details, media links, music, subtitles, and location data when TikTok supplies them. Creator rows include profile details, account flags, public counts, and the search rank. Each row keeps the keyword or expanded search value that first found it.

Choose Videos or Creators, enter one or more keywords, and start the Actor. The list and search setup are shared across the target you choose. For a shorter run and less review work, set the matching result limit. Leave a work limit empty to return all available results until the source is exhausted.

For video searches, choose the order: relevance, most liked, most viewed, most commented, most shared, or newest. You can keep only videos from a date range or a like range, and you can skip paid posts. You can also search TikTok suggestions, hashtags, or sounds found in the first video results. If the same public source item appears again through another keyword or expansion, only its first saved match is kept and later matches are ignored.

⚙️ Input

Input fields

FieldTypeWhat it does
targetstringChooses videos for public video posts or creators for public creator profiles. Options for the other target are ignored. Required. The form starts with videos.
videoResultLimitintegerFor Videos only, stops after this many videos for each keyword. Leave it empty or set 0 to return all available results until the source is exhausted. The form starts with 20.
videoSortOrderstringFor Videos only, orders the collected videos by relevance, mostLiked, mostViewed, mostCommented, mostShared, or newest. The default is relevance, which keeps TikTok's search order.
videoPublishedAfterstringFor Videos only, keeps videos posted on or after this UTC date. In JSON input, use YYYY-MM-DD. Leave it empty for no earliest date.
videoPublishedBeforestringFor Videos only, keeps videos posted on or before this UTC date. In JSON input, use YYYY-MM-DD. Leave it empty for no latest date.
videoMinLikesintegerFor Videos only, keeps videos with at least this many likes. Leave it empty for no minimum.
videoMaxLikesintegerFor Videos only, keeps videos with at most this many likes. Leave it empty for no maximum.
excludePaidPostsbooleanFor Videos only, skips videos that TikTok marks as paid posts. The default is false.
includeSuggestedSearchesbooleanFor Videos only, also searches TikTok suggestions for each keyword and records the value that first surfaces each saved video. The default is false.
includeHashtagExpansionbooleanFor Videos only, also searches hashtags found in the initial video results. The default is false.
includeMusicExpansionbooleanFor Videos only, also searches sounds found in the initial video results. The default is false.
creatorResultLimitintegerFor Creators only, stops after this many creator profiles for each keyword. Leave it empty or set 0 to return all available results until the source is exhausted.
searchKeywordsarray of stringsOne or more keywords used with one shared search setup for the selected target. Required. The form starts with recipe.

Video filters count toward the video limit only when a video passes them.

Leave the selected work limit empty to return all available results until the source is exhausted. Set a limit when you want fewer rows to review.

Example input

This is the public input from a successful current-beta run using the default video setup.

{
"searchKeywords": [
"recipe"
],
"target": "videos",
"videoResultLimit": 20,
"videoSortOrder": "relevance",
"excludePaidPosts": false,
"includeSuggestedSearches": false,
"includeHashtagExpansion": false,
"includeMusicExpansion": false
}

🧾 Output

Output fields

Each dataset row has one of the two shapes below. Optional fields appear when TikTok supplies them. Playback, cover, music, subtitle, and other media links stay hosted by TikTok.

Video result fields

FieldTypeWhat it does
resultTypestringThe row type, video.
resultRankintegerThe video position in the search results for this search keyword.
relatedSearchesarray of stringsRelated search suggestions that TikTok shows for this search keyword.
searchKeywordstringThe keyword or expanded search value that first found this video.
videoobjectPublic details for the TikTok video.
video.idstringPublic TikTok video ID.
video.captionstringText in the video caption.
video.hashtagsarray of stringsHashtags shown with the video.
video.publishedAtstringTime when the video was published.
video.urlstringPermanent public TikTok link for the video.
video.isPaidPostbooleanWhether TikTok marks the video as a paid post or ad.
video.engagementobjectPublic engagement totals for the video.
video.engagement.viewsintegerPublic view count.
video.engagement.likesintegerPublic like count.
video.engagement.commentsintegerPublic comment count.
video.engagement.sharesintegerPublic share count.
video.engagement.bookmarksintegerPublic bookmark count.
video.creatorobjectPublic identity and account totals for the video creator.
video.creator.idstringPublic TikTok ID for the creator.
video.creator.usernamestringCreator username on TikTok.
video.creator.displayNamestringCreator display name on TikTok.
video.creator.profileUrlstringPublic TikTok profile link for the creator.
video.creator.avatarUrlstringLink to the creator avatar image.
video.creator.biostringCreator bio text.
video.creator.isVerifiedbooleanWhether TikTok marks the creator as verified.
video.creator.followersintegerPublic follower count for the creator.
video.creator.followingintegerPublic account count that the creator follows.
video.creator.likesintegerPublic total likes on the creator account.
video.creator.videoCountintegerPublic number of videos on the creator account.
video.mediaobjectVideo size, playback, and cover details.
video.media.widthintegerVideo width in pixels.
video.media.heightintegerVideo height in pixels.
video.media.durationSecondsnumberVideo duration in seconds.
video.media.playbackUrlstringSource-hosted URL for playing the video.
video.media.coverUrlstringSource-hosted cover or thumbnail image URL.
video.musicobjectSound details when the video has available music data.
video.music.idstringPublic TikTok ID for the sound.
video.music.titlestringTitle of the sound.
video.music.artiststringArtist listed for the sound.
video.music.albumstringAlbum listed for the sound.
video.music.durationSecondsnumberSound duration in seconds.
video.music.coverUrlstringSource-hosted cover image URL for the sound.
video.subtitlesarray of objectsCaption tracks available for the video.
video.subtitles[].languagestringLanguage of the caption track.
video.subtitles[].formatstringFile format of the caption track.
video.subtitles[].urlstringSource-hosted URL for the caption track.
video.locationobjectPublic location details when TikTok supplies them.
video.location.idstringPublic TikTok ID for the location.
video.location.namestringPublic name of the location.
video.location.addressstringPublic address of the location.
video.location.citystringPublic city of the location.
video.location.countrystringPublic country of the location.

Example video row

This genuine row came from a successful current-beta run with the default recipe search. It includes music and subtitle data. Location fields are optional and are not present in this row.

{
"resultType": "video",
"searchKeyword": "recipe",
"resultRank": 16,
"video": {
"id": "7660288880272248078",
"caption": "Here is my One Pot Creamy Chicken Pasta Dinner 🤤🍝 full recipe on my website. Crispy on the outside, juicy and full of flavor chicken over a rich, creamy, cheesy pasta. Easy comfort food made in one pot! No mess no stress dinner 😊 One Pot Creamy Chicken Pasta: Ingredients Chicken 2 chicken breasts 1 tbsp olive oil 1–2 tbsp butter 1 tsp Cajun seasoning 1 tsp smoked paprika 1 tsp sweet paprika 1 tsp Italian seasoning 1 tsp garlic powder 1 tsp onion powder Salt and black pepper, to taste Pasta & Sauce 8 oz dry rigatoni 24 oz heavy cream 24 oz chicken broth (add more if needed) 1 tsp Cajun seasoning 1 tsp smoked paprika 1 tsp sweet paprika 1 tsp Italian seasoning 1 tsp garlic powder 1 tsp onion powder 1–2 cups shredded cheese of your choice (I used mozzarella, sharp cheddar, and medium cheddar) Optional Garnish Fresh parsley, chopped Grated Parmesan cheese Red pepper flakes Instructions Season the chicken: Coat the chicken breasts with olive oil, Cajun seasoning, smoked paprika, sweet paprika, Italian seasoning, garlic powder, onion powder, salt, and black pepper. Let the chicken marinate in the refrigerator for 15–30 minutes for the best flavor. Cook the chicken: Heat a large pot or skillet over medium-high heat and cook the chicken for about 2–3 minutes per side, or until golden brown and fully cooked. Remove the chicken from the pan and let it rest. Cook the pasta: In the same pot, add the rigatoni, heavy cream, chicken broth, 1–2 tbsp butter, and seasonings. Stir everything together, cover, and let the pasta simmer until al dente, stirring occasionally. Add more broth or cream if needed while the pasta cooks. Add the cheese: Once the pasta is cooked, add your shredded cheese and stir until melted and creamy. I used mozzarella, sharp cheddar, and medium cheddar, but feel free to use whatever cheese you have in the fridge. Finish and serve: Slice the rested chicken and place it on top of the creamy pasta. Garnish with fresh parsley, Parmesan cheese, or red pepper flakes if desired. #easyrecipe #pasta #chicken #familydinner #onepot ",
"hashtags": [
"easyrecipe",
"pasta",
"chicken",
"familydinner",
"onepot"
],
"publishedAt": "2026-07-08T22:33:44.000Z",
"url": "https://www.tiktok.com/@dadsfoodtoday/video/7660288880272248078",
"isPaidPost": false,
"engagement": {
"views": 8400000,
"likes": 791900,
"comments": 1919,
"shares": 159200,
"bookmarks": 320000
},
"creator": {
"id": "7265646866401821738",
"username": "dadsfoodtoday",
"displayName": "dadsfoodtoday",
"profileUrl": "https://www.tiktok.com/@dadsfoodtoday",
"isVerified": false,
"followers": 55800,
"following": 69,
"likes": 1900000,
"videoCount": 200,
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/2c5a6abaacfd7f92b7ba180e7dddd973~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=d4c7ca5f&x-expires=1793728800&x-signature=cfKjry2EZlNuqDL4vvqUxzHTHn8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3",
"bio": "Ben Decocker | NY 🇺🇸\nDad of 4 hungry boys\nQuick & Easy Family Meals \n👇 Get the full recipes"
},
"media": {
"width": 720,
"height": 1280,
"durationSeconds": 14,
"playbackUrl": "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=a794ca24f6234336b286d3795ee193ef&is_play_url=1&item_id=7660288880272248078&line=0&ply_type=2&pt=dGlrdG9rLnNlYXJjaC5hcGkmL2FwaS9zZWFyY2gvZ2VuZXJhbC9mdWxsLyYyMDI2MTEwMjAyMTc1NzlBRURDNzVFNjExQjk5QTBBMkZEJjE3OTM1NTcwNzcmMzIxNmUxNzcxNTYy&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjdkZDdiZmJhNDg4NDRlOTkzNjE1NTljNWRjOGI4Y2U4&tk=tt_chain_token&video_id=v12044gd0000d97d08fog65q5sfsisog",
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-0068-tx/oEQIfIcGAvAErFGLeAUjHAAQQC7xungfazWERk~tplv-tiktokx-origin.image?dr=14575&x-expires=1793728800&x-signature=OEZrWxMOB3VXN0hEBdG28aYm%2BE0%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2"
},
"music": {
"id": "6754420279457565445",
"title": "Mr. Blue Sky",
"artist": "Electric Light Orchestra",
"durationSeconds": 33,
"album": "Out of the Blue",
"coverUrl": "https://p77-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/oIAqeRU8MeQlFAMVK5MfOGW0AMOfAVeI1joAIr.jpeg"
},
"subtitles": [
{
"url": "https://v16-webapp.tiktok.com/faee30393e8617ebb211d429e15ea174/6aea2564/video/tos/alisg/tos-alisg-v-37c799-sg/29e927967edf480eb7b43f8b9d1de903/?a=1988&bti=ODszNWYuMDE6&&bt=11042&ft=IecA0oKyD12NvyYXUzIxRcJ_HlBF-UjNSbopiX&mime_type=video_mp4&rc=anZ2dnQ5cjtnPDMzZzczNEBpanZ2dnQ5cjtnPDMzZzczNEBsZmMyMmRjLTRhLS1kMS9zYSNsZmMyMmRjLTRhLS1kMS9zcw%3D%3D&l=202611020217579AEDC75E611B99A0A2FD&btag=e00078000",
"language": "eng-US",
"format": "webvtt"
}
]
},
"relatedSearches": [
"See the full recipe.",
"What is the full recipe?",
"What is the full recipe for this dish?",
"What is the full recipe for this?"
]
}

Creator result fields

FieldTypeWhat it does
resultTypestringThe row type, creator.
searchKeywordstringThe keyword that found this creator profile.
resultRankintegerCreator position returned for this search keyword.
creatorobjectPublic identity, profile, flags, and account totals for the creator.
creator.idstringPublic TikTok ID for the creator.
creator.usernamestringCreator username on TikTok.
creator.displayNamestringCreator display name on TikTok.
creator.profileUrlstringPublic TikTok profile link for the creator.
creator.biostringCreator bio text.
creator.websiteUrlstringPublic website linked from the creator profile.
creator.isVerifiedbooleanWhether TikTok marks the creator as verified.
creator.isPrivatebooleanWhether TikTok marks the creator account as private.
creator.isBusinessAccountbooleanWhether TikTok marks the creator account as a business account.
creator.followersintegerPublic follower count for the creator.
creator.followingintegerPublic account count that the creator follows.
creator.likesintegerPublic total likes on the creator account.
creator.videoCountintegerPublic number of videos on the creator account.

Example creator row

This genuine row came from a successful current-beta creator run.

{
"resultType": "creator",
"searchKeyword": "chef",
"resultRank": 1,
"creator": {
"id": "6782593777888789510",
"username": "abir.sag",
"profileUrl": "https://www.tiktok.com/@abir.sag",
"displayName": "Abir el saghir",
"bio": "Here to inspire your inner chef \n \"ولَا تَيْأَسوا مِن رَّوْحِ الله",
"websiteUrl": "https://youtu.be/IrohTcv5oJs?si=Y9bDB1JPMYaq1pfb",
"isVerified": true,
"isPrivate": false,
"isBusinessAccount": false,
"followers": 31400000,
"following": 41,
"likes": 530700000,
"videoCount": 1098
}
}

💳 Pricing

Pricing uses pay-per-event. You pay for each Video saved in a video search and each Creator saved in a creator search. Both events cost the same per row: $0.00405 on the Free plan, $0.0032 on Bronze, $0.0024 on Silver, $0.0016 on Gold and Platinum, and $0.00115 on Diamond. Set the result limit to control how many rows, and so how many charges, a run can have. The Apify Pricing tab is the source of truth if the displayed price changes.

🔌 Integrations

You can send the saved rows to other apps and Actors with Apify integrations. This guide shows how to connect Actors:

❓ FAQ

What happens if a video matches more than one keyword?

The Actor keeps the first saved match for that public video. Later appearances through another keyword or expansion are ignored, and the row keeps the first search value.

Can I search videos and creators in one run?

No. Choose one target for a run. The keyword list and shared search setup apply to that target, and options for the other target are ignored.

What if TikTok shows fewer results than my limit?

The Actor returns the available results it can collect during the run. TikTok search is fuzzy and availability changes, so an exact count or complete coverage is not promised.

Video rows include permanent public TikTok post links. Playback and cover links come from TikTok, and signed media links may expire.

Do I need a TikTok login or API key?

No. The Actor searches TikTok's public surface without a buyer login or source credential.

What does an empty result limit do?

Leave the selected work limit empty to return all available results until the source is exhausted. Set a limit when you want fewer rows and a smaller review task.

📝 Changelog

v1.0 (01-11-2026)

  • videoResultLimit now counts videos for each keyword, not for the whole run. If you search more than one keyword, divide your old limit by the number of keywords to keep about the same maximum total. Set it to 0 or leave it empty to get all results.
  • creatorResultLimit also accepts 0 to get all results.
  • Removed video.media.aspectRatio from the output. You can work it out from video.media.width and video.media.height, which stay in the output.
  • Removed video.location.region from the output, because it was always empty. There is no replacement.
  • New video sort orders: most viewed, most commented, and most shared.
  • New video filters: posted after a date, posted before a date, minimum likes, maximum likes, and skip paid posts.
  • New fields on video results: resultRank (the result position for its keyword), relatedSearches (related searches TikTok shows for the keyword), video.isPaidPost, video.creator.avatarUrl, and video.creator.bio.
  • Fixed runs that stalled or finished with no results, so searches now finish more reliably.
  • Reliability improvements.

v0.0

  • Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

Made with ❤️ by Maxime Dupré