Extract data from TikTok videos, hashtags, and users. Use URLs or search queries to scrape TikTok profiles, hashtags, posts, URLs, shares, followers, hearts, names, video, and music-related data. Export scraped data, run the scraper via API, schedule and monitor runs or integrate with other tools.
Just add one or more TikTok hashtags and the scraper will collect data about videos containing this hashtag: likes, users, followers and more. You can enter the hashtags one by one, or use the Bulk edit section to add a prepared list.
💯 Number of videos per hashtag, profile or search
resultsPerPageintegerOptional
Add the number of tiktoks you want to scrape per hashtag, profile, or search query. This field is applicable to #️⃣ Hashtags, 😎 Profiles, and 🔍 Search.
Default value of this property is 1
Usernames
profilesarrayOptional
Add one or multiple TikTok usernames you want to scrape. You can enter the usernames one by one, or use the Bulk edit section to add a prepared list.
Profile sections to scrape
profileScrapeSectionsarrayOptional
If a profile has reposted videos, you can scrape them by selecting 'Reposts'
Default value of this property is ["videos"]
Profile video sorting
profileSortingEnumOptional
Select Latest to scrape the most recent videos first, Oldest - the oldest videos first, Popular - the most popular videos first. Date filters only work with Latest and Oldest. Only supported for Videos section
Value options:
"latest": string"popular": string"oldest": string
Default value of this property is "latest"
Exclude pinned posts
excludePinnedPostsbooleanOptional
Tick to exclude pinned posts from profiles. Pinned posts are usually the first videos on a profile's page.
Default value of this property is false
📅 Date filter - scrape profile videos published after [date]
oldestPostDateUnifiedstringOptional
Optional charged filter. Only videos uploaded after or on this date will be scraped. Alternatively, specify how old the scraped videos should be in days. Putting 1 will get you only today's posts, 2 - yesterday's and today's, and so on.
📅 Date filter - scrape profile videos published before [date]
newestPostDatestringOptional
Optional charged filter. Only videos uploaded before or on this date will be scraped.
⭐ Popularity filter - scrape videos with number of hearts < [number]
mostDiggsintegerOptional
Optional charged filter. Scrapes only videos with less hearts than the number you add. Doesn't work with date filters
⭐ Popularity filter - scrape videos with number of hearts ≥ [number]
leastDiggsintegerOptional
Optional charged filter. Scrapes only videos with no less hearts than the number you add. Doesn't work with date filters
🗂️ Maximum number of followers profiles
maxFollowersPerProfileintegerOptional
Optional charged filter. Scrapes only profiles with less followers than the number you add.
🗂️ Maximum number of following profiles
maxFollowingPerProfileintegerOptional
Optional charged filter. Scrapes only profiles with less following profiles than the number you add.
Search queries
searchQueriesarrayOptional
Your keyword will apply to both videos and profiles. Use the Search sorting field below to specify whether you want your search to apply to top content, videos or users. As for your query's format, you can use any query that works on TikTok.
Search sorting
searchSectionEnumOptional
By default, this scraper will sort the search results by whatever shows up in the Top section of TikTok search. But you can narrow it down: if you want to apply your search query to just videos, use Video, just profiles - Profile.
Value options:
"/video": string"/user": string
Default value of this property is ""
Number of profiles per query
maxProfilesPerQueryintegerOptional
Only applies to profile searches. In this case ignore the 💯 Number of videos section and choose the number of profiles you want to scrape here.
Default value of this property is 10
Direct URLs for scraping specific tiktoks
postURLsarrayOptional
Add the URLs of tiktok videos you want to scrape. You can paste video URLs one by one, or use the Bulk edit section to add a prepared list.
Scrape related videos
scrapeRelatedVideosbooleanOptional
Tick to scrape related videos for the post URLs you provide.
The maximum number of scraped related videos is set by the resultsPerPage count.
Note that this only works for direct video URLs from the postURLs field.
Default value of this property is false
⬇️ Add-on: video download
shouldDownloadVideosbooleanOptional
This is a charged add-on. Tick to download TikTok videos.
Default value of this property is false
Include thumbnails
shouldDownloadCoversbooleanOptional
Tick to download TikTok video cover images (thumbnails). Note that this will increase time and costs needed to extract the data.
Default value of this property is false
Include subtitles
shouldDownloadSubtitlesbooleanOptional
Tick to download TikTok video subtitles (only when present on the video). Note that this will increase time and costs needed to extract the data.
Default value of this property is false
Download slideshow images
shouldDownloadSlideshowImagesbooleanOptional
Tick to download TikTok slideshow images. Note that this will increase costs and time required for scraping.
Default value of this property is false
Include profile avatars
shouldDownloadAvatarsbooleanOptional
Tick to download authors' profile pictures. Note that this will increase time and costs needed to extract the data.
Default value of this property is false
Include sound covers
shouldDownloadMusicCoversbooleanOptional
Tick to download cover images of sounds used in posts. Note that this will increase time and costs needed to extract the data.
Default value of this property is false
✍️ Name your storage for videos
videoKvStoreIdOrNamestringOptional
Name (or ID) of the Key Value Store where the videos and other media like thumbnails will be stored. Omit to store in the default one. Using this option will provide a named Key-Value store can help bypass data retention and store the content forever until the store is manually deleted.
The Key-Value store's name can consist of a versatile combination of uppercase letters, lowercase letters, digits, or hyphens, all without any spaces.
Proxy country
proxyCountryCodeEnumOptional
Country to use with proxy. Use it in case you want to scrape posts only available for some country.
