AS
Apify Store
/clockworks/tiktok-scraper
Scrape TikTok
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.
liveverifiedasyncdegraded · 14.0s~30s typical
tiktokvideoshashtagsprofiles
$0.0020
per result + $0.01 call
plus $0.001 platform fee per run
Usage-based actor: event charges passed through at cost plus 25%
Bring your own Apify Store key: provider portion drops to $0.
$Set up https://cracked-ai-pearl.vercel.app/SKILL.md, then use Cracked to run apify /clockworks/tiktok-scraper for me.
Input
| Field | Type | Description |
|---|---|---|
| hashtags | array | Just add one or more TikTok hashtags and the scraper will collect data about videos containing this hashtag: likes, users, followers and more. <br> You can enter the hashtags one by one, or use the <strong>Bulk edit</strong> section to add a prepared list. |
| resultsPerPage | integer | Add the number of tiktoks you want to scrape per hashtag, profile, or search query. This field is applicable to <strong>#️⃣ Hashtags</strong>, <strong>😎 Profiles</strong>, and <strong>🔍 Search</strong>. default 1 |
| profiles | array | Add one or multiple TikTok usernames or user IDs you want to scrape. You can enter the usernames one by one, or use the <strong>Bulk edit</strong> section to add a prepared list. |
| profileScrapeSections | array | If a profile has reposted videos, you can scrape them by selecting 'Reposts'. If a profile currently has an active story, you can scrape it by selecting 'Stories' default ["videos"] |
| profileSorting | string (latest | popular | oldest) | 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. default "latest" |
| excludePinnedPosts | boolean | Tick to exclude pinned posts from profiles. Pinned posts are usually the first videos on a profile's page. default false |
| oldestPostDateUnified | string | 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 <code>1</code> will get you only today's posts, <code>2</code> - yesterday's and today's, and so on. |
| newestPostDate | string | Optional charged filter. Only videos uploaded before or on this date will be scraped. |
| mostDiggs | integer | Optional charged filter. Scrapes only videos with less hearts than the number you add. Doesn't work with date filters |
| leastDiggs | integer | Optional charged filter. Scrapes only videos with no less hearts than the number you add. Doesn't work with date filters |
| maxFollowersPerProfile | integer | 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 | integer | 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. |
| searchQueries | array | Your keyword will apply to both videos <strong>and</strong> profiles. Use the <strong>Search sorting</strong> field below to specify whether you want your search to apply to top content, videos or users. <br> As for your query's format, you can use any query that works on TikTok. |
| searchSection | string ( | /video | /user) | By default, this scraper will sort the search results by whatever shows up in the <strong>Top</strong> section of TikTok search. <br> But you can narrow it down: if you want to apply your search query to just videos, use <strong>Video</strong>, just profiles - <strong>Profile</strong>. default "" |
| maxProfilesPerQuery | integer | Only applies to profile searches. In this case ignore the <strong> 💯 Number of videos </strong> section and choose the number of profiles you want to scrape here. default 10 |
| videoSearchSorting | string (MOST_RELEVANT | MOST_LIKED | LATEST) | Optional charged filter. Select how you want the search results to be sorted when searching for videos. Only valid with `/video` search section. default "MOST_RELEVANT" |
| videoSearchDateFilter | string (ALL_TIME | PAST_24_HOURS | PAST_WEEK | PAST_MONTH | LAST_3_MONTHS | LAST_6_MONTHS) | Optional charged filter. Select a date range in which to search for videos. Only valid with `/video` search section. default "ALL_TIME" |
| scrapeRelatedSearchWords | boolean | 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. default false |
| postURLs | array | Add the URLs of tiktok videos you want to scrape. You can paste video URLs one by one, or use the <strong>Bulk edit</strong> section to add a prepared list. |
| scrapeRelatedVideos | boolean | 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 false |
| scrapeAdditionalAuthorMeta | boolean | 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). default false |
| shouldDownloadVideos | boolean | This is a charged add-on. Tick to download TikTok videos. default false |
| shouldDownloadCovers | boolean | Tick to download TikTok video cover images (thumbnails). default false |
| shouldDownloadSlideshowImages | boolean | Tick to download TikTok slideshow images. default false |
| shouldDownloadAvatars | boolean | Tick to download authors' profile pictures. default false |
| shouldDownloadMusicCovers | boolean | Tick to download cover images of sounds used in posts. default false |
| videoKvStoreIdOrName | string | 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.<br><br>The Key-Value store's name can consist of a versatile combination of uppercase letters, lowercase letters, digits, or hyphens, all without any spaces. |
| downloadSubtitlesOptions | string (NEVER_DOWNLOAD_SUBTITLES | DOWNLOAD_SUBTITLES | DOWNLOAD_AND_TRANSCRIBE_VIDEOS_WITHOUT_SUBTITLES | TRANSCRIBE_ALL_VIDEOS) | 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. default "NEVER_DOWNLOAD_SUBTITLES" |
| aiVideoDescription | boolean | 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. default false |
| aiVideoSummary | boolean | 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. default false |
| commentsPerPost | integer | 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. |
| topLevelCommentsPerPost | integer | The maximum number of top-level (non-reply) comments you want from a single post. |
| maxRepliesPerComment | integer | The maximum number of replies you want from a single comment. Note: Successful extraction of all desired replies is currently not guaranteed. |
| proxyCountryCode | string (None | AF | AL | DZ | AS | AD) | Country to use with proxy. Use it in case you want to scrape posts only available for some country. default "None" |
Call it
curl
curl https://cracked-ai-pearl.vercel.app/v1/run \
-H "Authorization: Bearer ck_live_..." -H "content-type: application/json" \
-d '{"provider":"apify","endpoint":"/clockworks/tiktok-scraper","input":{"hashtags":["glp1"],"resultsPerPage":20},"wait":false}'poll
curl "https://cracked-ai-pearl.vercel.app/v1/runs/<runId>?wait=30" -H "Authorization: Bearer ck_live_..."cli
npx cracked-ai run -p apify -e /clockworks/tiktok-scraper -i '{"hashtags":["glp1"],"resultsPerPage":20}' -w 120mcp
run_tool({ provider: "apify", endpoint: "/clockworks/tiktok-scraper", input: {"hashtags":["glp1"],"resultsPerPage":20}, wait: false })Try it
Runs against your signed-in workspace balance. Sign in if you have not.