{"uid":"cap_FRvE5so9nOxTY8a79DIDk","slug":"tiktok-scraper-clockworks-via-stableapify-3587258d","name":"TikTok Scraper (clockworks) via StableApify","description":"Start the \"TikTok Scraper\" Apify actor (clockworks/tiktok-scraper). Extract data from TikTok videos, hashtags, and users. Use URLs or search queries to scrape TikTok profiles, hashtags, posts, URLs, shares, followers, hearts, n…","url":"https://stableapify.dev/api/actors/clockworks/tiktok-scraper/call","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","required":["resultsPerPage","profileScrapeSections","profileSorting","excludePinnedPosts","searchSection","maxProfilesPerQuery","videoSearchSorting","videoSearchDateFilter","scrapeRelatedVideos","shouldDownloadVideos","shouldDownloadCovers","shouldDownloadSlideshowImages","shouldDownloadAvatars","shouldDownloadMusicCovers","downloadSubtitlesOptions","proxyCountryCode"],"properties":{"hashtags":{"type":"array","items":{"type":"string"},"description":"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":{"type":"array","items":{"type":"string"},"description":"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":{"type":"array","items":{"type":"string"},"description":"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":{"type":"integer","maximum":9007199254740991,"minimum":1,"description":"Optional charged filter. Scrapes only videos with less hearts than the number you add. Doesn't work with date filters"},"leastDiggs":{"type":"integer","maximum":9007199254740991,"minimum":1,"description":"Optional charged filter. Scrapes only videos with no less hearts than the number you add. Doesn't work with date filters"},"searchQueries":{"type":"array","items":{"type":"string"},"description":"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":{"enum":["","/video","/user"],"type":"string","default":"","description":"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 ."},"newestPostDate":{"type":"string","description":"Optional charged filter. Only videos uploaded before or on this date will be scraped."},"profileSorting":{"enum":["latest","popular","oldest"],"type":"string","default":"latest","description":"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"},"resultsPerPage":{"type":"integer","default":1,"maximum":1000000,"minimum":1,"description":"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":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"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":{"enum":["None","AF","AL","DZ","AS","AD","AO","AI","AG","AR","AM","AU","AT","AZ","BS","BH","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BR","VG","BN","BG","BF","BI","KH","CM","CA","CV","KY","TD","CL","CO","CK","CR","HR","CY","CZ","CD","DK","DJ","DO","EC","EG","SV","EE","ET","FK","FJ","FI","FR","PF","GA","GE","DE","GH","GI","GR","GL","GD","GP","GT","GN","GW","GY","HN","HU","IS","ID","IQ","IE","IM","IL","IT","CI","JM","JP","JE","KZ","KE","XK","KW","LA","LV","LB","LS","LR","LY","LT","LU","MO","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","MX","MD","MC","MN","ME","MA","MZ","MM","NA","NR","NP","NL","NZ","NI","NG","MK","NO","OM","PS","PA","PG","PY","PE","PH","PL","PT","PR","QA","CG","RO","RU","RW","RE","KN","LC","MF","PM","VC","SM","SA","SN","RS","SL","SG","SX","SK","SB","SO","ZA","KR","ES","LK","SR","SZ","SE","CH","TW","TJ","TZ","TH","TG","TO","TT","TN","TR","TC","TV","VI","UG","UA","AE","GB","US","UY","VE","VN","WF","YE","ZM","ZW","AX"],"type":"string","default":"None","description":"Country to use with proxy. Use it in case you want to scrape posts only available for some country."},"excludePinnedPosts":{"type":"boolean","default":false,"description":"Tick to exclude pinned posts from profiles. Pinned posts are usually the first videos on a profile's page."},"videoSearchSorting":{"enum":["MOST_RELEVANT","MOST_LIKED","LATEST"],"type":"string","default":"MOST_RELEVANT","description":"Optional charged filter. Select how you want the search results to be sorted when searching for videos. Only valid with `/video` search section."},"maxProfilesPerQuery":{"type":"integer","default":10,"maximum":9007199254740991,"minimum":1,"description":"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":{"type":"boolean","default":false,"description":"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":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"The maximum number of replies you want from a single comment. Note: Successful extraction of all desired replies is currently not guaranteed."},"shouldDownloadCovers":{"type":"boolean","default":false,"description":"Tick to download TikTok video cover images (thumbnails)."},"shouldDownloadVideos":{"type":"boolean","default":false,"description":"This is a charged add-on. Tick to download TikTok videos."},"videoKvStoreIdOrName":{"type":"string","pattern":"^[a-zA-Z0-9-]+$","description":"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":{"type":"string","pattern":"^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?Z?)?$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$","description":"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":{"type":"array","items":{"enum":["videos","reposts"],"type":"string"},"default":["videos"],"description":"If a profile has reposted videos, you can scrape them by selecting 'Reposts'"},"shouldDownloadAvatars":{"type":"boolean","default":false,"description":"Tick to download authors' profile pictures."},"videoSearchDateFilter":{"enum":["ALL_TIME","PAST_24_HOURS","PAST_WEEK","PAST_MONTH","LAST_3_MONTHS","LAST_6_MONTHS"],"type":"string","default":"ALL_TIME","description":"Optional charged filter. Select a date range in which to search for videos. Only valid with `/video` search section."},"maxFollowersPerProfile":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"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":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"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":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"The maximum number of top-level (non-reply) comments you want from a single post."},"downloadSubtitlesOptions":{"enum":["NEVER_DOWNLOAD_SUBTITLES","DOWNLOAD_SUBTITLES","DOWNLOAD_AND_TRANSCRIBE_VIDEOS_WITHOUT_SUBTITLES","TRANSCRIBE_ALL_VIDEOS"],"type":"string","default":"NEVER_DOWNLOAD_SUBTITLES","description":"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."},"shouldDownloadMusicCovers":{"type":"boolean","default":false,"description":"Tick to download cover images of sounds used in posts."},"shouldDownloadSlideshowImages":{"type":"boolean","default":false,"description":"Tick to download TikTok slideshow images."}},"description":"Normalized actor input. See field descriptions for the simplified shape; native Apify input also accepted (passed through).","additionalProperties":{}},"options":{"type":"object","properties":{"build":{"type":"string","maxLength":100,"minLength":1},"memory":{"type":"integer","maximum":32768,"minimum":128},"maxItems":{"type":"integer","maximum":100000,"minimum":1}},"description":"Optional Apify run options.","additionalProperties":false}}},"responseSchema":null,"example":{"request":{"input":{"username":"sarptecimer","includeEmail":false},"options":{"memory":1024,"maxItems":100}},"response":{"run":{"id":"CGIdHMgvN41li0b2n","status":"READY","actorId":"GdWCkxBtKWOsKjdch","startedAt":"2026-06-16T17:42:49.771Z","usageTotalUsd":0,"defaultDatasetId":"SQhoVdVXqeE3EHxpf"},"token":"eyJhbGciOiJIUzI1NiJ9.eyJydW5JZCI6IkNHSWRITWd2TjQxbGkwYjJuIiwiYWN0b3JJZCI6ImNsb2Nrd29ya3MvdGlrdG9rLXNjcmFwZXIiLCJkZWZhdWx0RGF0YXNldElkIjoiU1Fob1ZkVlhxZUUzRUh4cGYiLCJ3IjoiMHg5Y2M0MmYzZDkyNDViODY3YWNjY2Q2MzBiNDNmOTA2YzE2NjViMTc2IiwiaWF0IjoxNzgxNjMxNzY5LCJleHAiOjE3ODQyMjM3Njl9.GGxotobhwGvUmq2r3PMHLNSB8G9M61pQTmseWDytn6Y"}},"exampleRequest":{"input":{"username":"sarptecimer","includeEmail":false},"options":{"memory":1024,"maxItems":100}},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-Y_R5mEjvQMKvInxhiXmW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Starts an Apify actor run to scrape TikTok profiles, videos, hashtags, and posts by username, URL, or search query, returning a run ID and dataset token for result retrieval.","exampleAgentPrompt":"Scrape the TikTok profile and up to 100 videos for the user 'sarptecimer' — I need their follower count, heart count, and post metadata. Use 1024 MB memory and don't include email addresses.","exampleUseCases":[{"title":"Influencer research for brand campaign","prompt":"Pull TikTok data for the account 'charlidamelio' — I need up to 200 of their recent videos, follower count, and average engagement. Use 1024 MB memory and cap it at 200 items."},{"title":"Hashtag trend analysis","prompt":"Scrape TikTok posts for the hashtag #BookTok and return up to 500 posts including video URLs, like counts, and share counts. Use 2048 MB memory."},{"title":"Competitor content audit","prompt":"Extract all public video metadata from TikTok user 'duolingo' — up to 150 videos — including post dates, heart counts, and captions. Set memory to 1024 MB and skip email collection."}],"resultDescription":"Returns a JSON object with the actor run ID, run status (e.g. READY), actor ID, start timestamp, total cost in USD, the default dataset ID (for polling results), and a JWT bearer token used to authenticate subsequent dataset fetch calls.","failureModes":["Invalid username or URL returns an error or empty dataset","Actor run may enter FAILED status if TikTok blocks the scrape","Memory limit too low for large scrapes causes run failure","Token expiry (valid ~30 days) prevents dataset retrieval if not fetched in time","Rate limiting or account restrictions on TikTok side yield incomplete results","Missing or malformed input fields return a 4xx error from the API"],"whenToPreferThis":"Choose this endpoint when you need to extract structured TikTok data (profiles, videos, hashtags) at scale without managing your own scraping infrastructure. Prefer it over the apidojo/tiktok-scraper variant when the clockworks actor's feature set (URL-based scraping, username lookup, hashtag data) matches your use case and cost sensitivity matters at $0.01 per run start.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:50:54.886Z","isFirstParty":false}