{"uid":"cap_3kfY8XSU5mcMbq0Z5E7gz","slug":"tiktok-data-extractor-apify-clockworks-free-tiktok-scraper-ba5d5324","name":"TikTok Data Extractor (Apify clockworks/free-tiktok-scraper)","description":"Start the \"TikTok Data Extractor\" Apify actor (clockworks/free-tiktok-scraper). Extract data about videos, users, and channels based on hashtags or scrape full user profiles including posts, total likes, name, nickname, numbers of comments…","url":"https://apify-api-git-br-better-actor-pay-merit-systems.vercel.app/api/actors/clockworks/free-tiktok-scraper/call","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["resultsPerPage","profileScrapeSections","profileSorting","excludePinnedPosts","searchSection","maxProfilesPerQuery","shouldDownloadVideos","shouldDownloadCovers","shouldDownloadSubtitles","shouldDownloadSlideshowImages"],"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 you want to scrape. You can enter the usernames one by one, or use the Bulk edit section to add a prepared list."},"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 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 ."},"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."},"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."},"shouldDownloadCovers":{"type":"boolean","default":false,"description":"Tick to download TikTok video cover images (thumbnails). Note that this will increase time and costs needed to extract the data."},"shouldDownloadVideos":{"type":"boolean","default":false,"description":"Tick to download TikTok videos. Note that this will increase time and costs needed to extract the data."},"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 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'"},"shouldDownloadSubtitles":{"type":"boolean","default":false,"description":"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."},"shouldDownloadSlideshowImages":{"type":"boolean","default":false,"description":"Tick to download TikTok slideshow images. Note that this will increase costs and time required for scraping."}},"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}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"input":{"hashtags":["artificialintelligence"],"resultsPerPage":10,"profileScrapeSections":["videos"]}},"response":{"run":{"id":"IFwUNbfbYxYObwpzG","status":"READY","actorId":"OtzYfK1ndEGdwWFKQ","startedAt":"2026-05-29T04:44:33.979Z","usageTotalUsd":0,"defaultDatasetId":"AfUQf2oWhm8GRg9zF"},"token":"eyJhbGciOiJIUzI1NiJ9.eyJydW5JZCI6IklGd1VOYmZiWXhZT2J3cHpHIiwiYWN0b3JJZCI6ImNsb2Nrd29ya3MvZnJlZS10aWt0b2stc2NyYXBlciIsImRlZmF1bHREYXRhc2V0SWQiOiJBZlVRZjJvV2htOEdSZzl6RiIsInciOiIweDljYzQyZjNkOTI0NWI4NjdhY2NjZDYzMGI0M2Y5MDZjMTY2NWIxNzYiLCJpYXQiOjE3ODAwMjk4NzQsImV4cCI6MTc4MjYyMTg3NH0.E3BLcRR5C6KuRU1R8w6Un93A1ULYhjEsRDSTmNRd3tk"}},"exampleRequest":{"input":{"hashtags":["artificialintelligence"],"resultsPerPage":10,"profileScrapeSections":["videos"]}},"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_6-Vg66Of6ofiWv5jPNE9b","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes TikTok videos, user profiles, and channel data by hashtag or username, returning posts, likes, comments, follower counts, and profile metadata.","exampleAgentPrompt":"Pull the full TikTok profile for @charlidamelio — I want her total likes, follower count, nickname, and her last 50 posts with comment counts.","exampleUseCases":null,"resultDescription":"Returns a signed token for polling /api/actors/status to track job progress and fetching /api/actors/results (paid on first call per wallet). Results include TikTok video metadata, user profile fields (name, nickname, follower count, total likes), and per-post engagement data (comments, likes, shares).","failureModes":["TikTok rate limiting or anti-bot measures causing empty or partial results","Invalid or private username/hashtag returning no data","Actor timeout on very large profiles with thousands of posts","Payment failure or insufficient USDC balance blocking execution","Stale or deleted TikTok content returning 404-equivalent empty records"],"whenToPreferThis":"Use this endpoint when you need structured TikTok profile or hashtag data at scale via a managed cloud actor, especially when you want to avoid maintaining your own scraper infrastructure. Prefer this over manual scraping or other social media APIs when TikTok-specific data (nicknames, total likes, video metadata) is needed and a small per-call cost is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:41:27.258Z","isFirstParty":false}