← API Catalog
Apify·Async
TikTok Scraper
What it does
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.
Returns: 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.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
hashtags | array | No | 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. |
postURLs | array | No | 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. |
profiles | array | No | Add one or multiple TikTok usernames or user IDs you want to scrape. You can enter the usernames one by one, or use the Bulk edit section to add a prepared list. |
mostDiggs | number | No | Optional charged filter. Scrapes only videos with less hearts than the number you add. Doesn't work with date filters |
leastDiggs | number | No | Optional charged filter. Scrapes only videos with no less hearts than the number you add. Doesn't work with date filters |
searchQueries | array | No | 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. |
searchSection | select | No | 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. |
aiVideoSummary | boolean | No | Use AI to generate a high-level summary of each video as a piece of content. Provided inline under videoMeta.aiVideoSummary. Charged per video-second, only when the summary is produced successfully. |
newestPostDate | text | No | Optional charged filter. Only videos uploaded before or on this date will be scraped. |
profileSorting | select | No | 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. Note: Popular sorting is limited by TikTok to approximately 400–500 videos per profile and may return significantly fewer results than Latest or Oldest. |
resultsPerPage | number | No | Add the number of tiktoks you want to scrape per hashtag, profile, or search query. This field is applicable to #️⃣ Hashtags, 😎 Profiles, and 🔍 Search. |
commentsPerPost | number | No | The number of comments extracted from every result. Due to TikTok API limitations, the actual number of scraped comments may differ, especially for posts with thousands of comments. The link to the dataset will be under a field commentsDatasetURL in the output. |
proxyCountryCode | select | No | Country to use with proxy. Use it in case you want to scrape posts only available for some country. |
aiVideoDescription | boolean | No | Use AI to generate a time-segmented description of each video (what is seen and heard, per scene). Provided inline under videoMeta.aiVideoDescription. Charged per video-second, only when the description is produced successfully. |
excludePinnedPosts | boolean | No | Tick to exclude pinned posts from profiles. Pinned posts are usually the first videos on a profile's page. |
maxProfilesPerQuery | number | No | 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. |
scrapeRelatedVideos | boolean | No | 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. |
maxRepliesPerComment | number | No | The maximum number of replies you want from a single comment. Note: Successful extraction of all desired replies is currently not guaranteed. |
shouldDownloadCovers | boolean | No | Tick to download TikTok video cover images (thumbnails). |
shouldDownloadVideos | boolean | No | This is a charged add-on. Tick to download TikTok videos. |
videoKvStoreIdOrName | text | No | 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. |
oldestPostDateUnified | text | No | 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. |
profileScrapeSections | select | No | If a profile has reposted videos, you can scrape them by selecting 'Reposts' |
shouldDownloadAvatars | boolean | No | Tick to download authors' profile pictures. |
maxFollowersPerProfile | number | No | Scrapes number of 'Followers' profiles requested from the inputted profiles. You can find the link to the dataset under the followDatasetUrl field in the output. If you want to scrape only Followers/Following profiles, go to our TikTok Followers Scraper. |
maxFollowingPerProfile | number | No | Scrapes number of 'Following' profiles requested from the inputted profiles. You can find the link to the dataset under the followDatasetUrl field in the output. If you want to scrape only Followers/Following profiles, go to our TikTok Followers Scraper. |
topLevelCommentsPerPost | number | No | The maximum number of top-level (non-reply) comments you want from a single post. |
downloadSubtitlesOptions | select | No | Choose how to handle subtitles and audio transcription for input videos. Subtitles are provided by TikTok for some videos, and transcription means that this Actor will use speech-to-text AI to generate video transcript. Transcripts are charged as an extra event according to your plan. |
scrapeRelatedSearchWords | boolean | No | Tick to include the keywords TikTok shows in the 'Others also searched for' section on the search results page. The words will be added to every video result. |
shouldDownloadMusicCovers | boolean | No | Tick to download cover images of sounds used in posts. |
scrapeAdditionalAuthorMeta | boolean | No | Tick to fetch full author profile data (createTime, roomId) for each scraped video. Note: when scraping by profile URL, this data is already included by default — this option only makes a difference for other search types (e.g. hashtags, keywords). |
shouldDownloadSlideshowImages | boolean | No | Tick to download TikTok slideshow images. |
Endpoints
GET
/v1/agents/resources/inspect/apify.clockworks.tiktok-scraperPublicPOST
/v1/agents/resources/estimate/apify.clockworks.tiktok-scraperPublicPOST
/v1/agents/resources/run/apify.clockworks.tiktok-scraperAgent keyGET
/v1/agents/resources/runs/{run_id}Agent keyQuick start
Run it with one Agent One Key over the OpenAI-compatible resource rail.
curl -X POST https://api.deva.me/v1/agents/resources/run/apify.clockworks.tiktok-scraper \
-H "Authorization: Bearer deva_i1_your_key_here" \
-H "Content-Type: application/json" \
--data '{
"params": {}
}'Related in Social
Instagram Scraper
Extract Instagram posts, reels, profiles, places, hashtags, carousels, and comments. Get data from Instagram using one or more Instagram URLs or search queries: content, context, metrics, metadata. Export scraped data, run the scraper via API, schedule and monitor runs or integrate with other tools.
Tweet Scraper V2 - X / Twitter Scraper
Lightning-fast search, URL, list, and profile scraping, with customizable filters. At $0.40 per 1000 tweets, and 30-80 tweets per second, it is ideal for researchers, entrepreneurs, and businesses! Get comprehensive insights from Twitter (X) now!
Instagram Profile Scraper
Scrape all Instagram profile info. Just add Instagram usernames, IDs or URLs and extract name, join date, number of followers, location, bio, website, related profiles, video&post count, latest posts. Export scraped data, schedule scraper via API, and integrate with other tools or AI workflows.
Instagram Post Scraper
Scrape Instagram posts. Just add one or more Instagram usernames and get your data in seconds including caption, metrics, images, mentions, coauthors, recent comments, sponsored status, video duration, views. Export scraped data, schedule scraper via API, integrate with other tools or AI workflows.
Facebook Posts Scraper
Extract posts, videos, and engagement metrics from Facebook pages. Get text captions, reactions, video transcripts, images, external links, collaborators, and more from Facebook pages and profiles. Export ad data, schedule runs via API, and integrate with other tools or AI workflows.
YouTube Scraper
YouTube crawler and video scraper. Alternative YouTube API with no limits or quotas. Extract and download channel name, likes, number of views, and number of subscribers.