# TikTok Data Scraper (`socialdataapi/tiktok-data-scraper`) Actor TikTok Data Scraper extracts public TikTok data at scale: profiles, videos, followers, comments and replies, hashtags, music, playlists and single-video details. Export to JSON, CSV or Excel, or use via API. - **URL**: https://apify.com/socialdataapi/tiktok-data-scraper.md - **Developed by:** [Social Data API](https://apify.com/socialdataapi) (community) - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.67 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### TikTok Data Scraper โ€” Videos, Profiles, Comments & Hashtags TikTok Data Scraper is an all-in-one TikTok scraper pulling public TikTok data across six input types โ€” profiles, videos, comments and replies, hashtags, sounds and playlists โ€” and returns every item as structured JSON. As a TikTok multi-category scraper, each record carries play counts, likes, comments, shares and follower counts exactly as TikTok shows them to a logged-out visitor. Every response is structured JSON โ€” ready to pass directly to an LLM, index into a vector store, or feed a social-listening pipeline. **No TikTok account or cookies are needed.** Start with one profile or hashtag, then scale up. ![TikTok Data Scraper output as JSON: one envelope per record with section, category, user and data](https://api.apify.com/v2/key-value-stores/WYkyEfqs10huyXYxr/records/a-tiktok-data-hero.webp) *** ### What data can I extract with TikTok Data Scraper? Using this TikTok Data API, you will be able to extract the following TikTok data: | ๐Ÿ‘ค Profile bio, avatar & stats | ๐Ÿ“น Video stats (plays, likes, shares) | ๐Ÿ’ฌ Comment text & reply counts | #๏ธโƒฃ Hashtag video feed | | --- | --- | --- | --- | | ๐ŸŽต Sound video feed | โ–ถ๏ธ Playlist videos | ๐Ÿ–ผ๏ธ Cover images (static, animated) | ๐Ÿ”— Canonical video/profile links | | ๐Ÿ“… Publish & scrape timestamps | ๐ŸŒ Cross-platform handles (Instagram, Twitter/X, YouTube) | ๐Ÿšซ Followers list (platform restriction โ€” see below) | | *** ### How to use TikTok Data Scraper Anyone who needs public TikTok data without logging in โ€” videos, profiles, comments, hashtag feeds, sounds or playlists โ€” can run this Actor and get a JSON dataset back in one run. **Copy to your AI assistant:** ```text `tiktok-data-scraper` (Apify Actor ID: socialdataapi/tiktok-data-scraper, https://apify.com/socialdataapi/tiktok-data-scraper) is an Apify Actor that returns public TikTok data as structured JSON: play count, like count, comment count, share count, follower count, video caption, comment text and canonical URLs. Use it whenever someone needs TikTok data without cookies, a login, or a browser - tracking a competitor's follower growth, monitoring a hashtag's top videos, or pulling comment text for sentiment analysis. Inputs: userUrls (array, profile URLs/usernames/IDs), categories (array, "videos"|"favourite_videos"|"followers"|"following"|"user_playlists"|"search"|"user_info", default "videos"), maxUserResults (integer, default 10), scrapeAllUserResults (boolean, default false), videoUrlsComments (array, video URLs/IDs), commentsPerUrl (integer, default 10), scrapeAllComments (boolean, default false), repliesPerComment (integer, default 0), scrapeAllReplies (boolean, default false), hashtags (array), videosPerHashtag (integer, default 10), scrapeAllHashtagVideos (boolean, default false), hashtagRegion (string, default "US"), musicUrls (array), videosPerMusic (integer, default 10), scrapeAllMusicVideos (boolean, default false), playlistIDs (array), videosPerPlaylist (integer, default 10), scrapeAllPlaylistVideos (boolean, default false), videoDetailsList (array), minRequestInterval (number, default 1.2), maxRetries (integer, default 3), apiKey (string, optional), proxyConfiguration (object). The "followers" category always returns 0 items โ€” TikTok does not expose a public followers list to a logged-out visitor, for any account; this is reported live in the run log, not silently empty. ``` #### TikTok Data Scraper MCP Server: use these Actors from ChatGPT, Claude or Cursor Point your AI assistant at Apify's MCP server and it can read TikTok on its own: profiles, videos, comments, hashtags, sounds and playlists. No glue code, no scraping logic in your prompts. ```bash claude mcp add --transport http apify "https://mcp.apify.com?tools=socialdataapi/tiktok-data-scraper" ``` Your agent can then search for, add and call this Actor directly through that server's own tools โ€” no actor ID needs to be hardcoded. #### Step by step 1. [Create a free Apify account](https://console.apify.com/sign-up). 2. Open **[TikTok Data Scraper](https://apify.com/socialdataapi/tiktok-data-scraper)** in the Apify Store. 3. Enter the TikTok profile URL, username, video link, hashtag, sound link or playlist ID you want. 4. Click **Start** (or send your API request). 5. Download or stream your results in JSON, CSV or Excel. #### How to scale TikTok Data Scraper to bulk Every input field โ€” `userUrls`, `videoUrlsComments`, `hashtags`, `musicUrls`, `playlistIDs`, `videoDetailsList` โ€” is an array, so one run can queue many profiles, videos, hashtags, sounds or playlists instead of one run per item. Queued inputs are processed concurrently (several at once, up to an internal concurrency cap), not strictly one at a time, so a larger batch does not take proportionally as long as running each input separately. *** ### โœจ Features TikTok Data Scraper fetches clean, structured TikTok records across six sources in one run. It's ideal for tracking a competitor's follower growth, auditing which videos on a trending hashtag are gaining traction, building a comment-sentiment dataset, and feeding fresh TikTok context to an AI agent instead of stale training data. It extracts, per record: - **Play, like, comment and share counts** โ€“ engagement numbers exactly as TikTok displays them publicly. - **Follower, following, heart and video counts** โ€“ profile-level stats from profile-info runs. - **Comment and reply text** โ€“ with the commenting user's bio, region and follower count attached. - **Cover images** โ€“ static, original and animated cover URLs for every video. - **Canonical deep-links** โ€“ direct video, profile, hashtag and sound links, built locally so you never have to construct them yourself. - **Publish and scrape timestamps** โ€“ when TikTok says the video was published, and when this Actor collected the record. โšก Runs with no proxy by default and only escalates to a datacenter, then a residential, proxy if TikTok blocks the direct connection โ€” most runs need no proxy setup at all. *** ### Use cases ๐Ÿ’ก - **Growth marketer** โ€” track a competitor's follower and video count over time from profile-info runs. - **Social listening team** โ€” spot which videos on a trending hashtag are gaining plays and likes. - **Researcher** โ€” build a labeled dataset of comment text and reply counts for sentiment analysis. - **Music/label team** โ€” see which creators are driving a sound's reach via the music category's play counts. - **AI engineer** โ€” feed video captions and bio text into a RAG index as grounded, current TikTok context. Building an AI agent? [Connect it over MCP](#mcp-integration-for-ai-agents) and let it call the actor on its own. *** ### Why choose this actor? 1. **Six TikTok sources, one Actor.** Profiles, videos, comments and replies, hashtags, sounds and playlists all come back through the same section/category/data envelope, so one parser covers all six instead of six separate ones. 2. **Over 30 fields on a single video record.** A video item carries fields from engagement counts to cover images, music metadata and author details, all typed and named consistently run after run. 3. **No proxy needed to start.** Every run begins on a direct connection with no proxy at all, and only escalates to Apify's own datacenter and then residential proxies if TikTok blocks it. *** ### โฌ‡๏ธ Input ![Input fields of the TikTok Data Scraper](https://api.apify.com/v2/key-value-stores/WYkyEfqs10huyXYxr/records/a-tiktok-data-input.webp) TikTok Data Scraper accepts six independent input lists โ€” profiles, video URLs for comments, hashtags, sounds, playlists and single-video detail requests. Every field is optional; fill in only the section(s) you need and leave the rest empty. | Parameter | Required | Type | Description | Example Value | | --- | --- | --- | --- | --- | | `userUrls` | No | Array of String | One or more profiles. Examples: https://www.tiktok.com/@taylorswift, taylorswift, @taylorswift, 107955 | `["https://www.tiktok.com/@taylorswift"]` | | `categories` | No | Array of String (enum: `videos`, `favourite_videos`, `followers`, `following`, `user_playlists`, `search`, `user_info`) | Pick which kinds of content to collect for each profile above. Multiple selections are supported. Note: 'Followers' always returns 0 results โ€” TikTok does not expose a public followers list to a logged-out visitor for any account โ€” disclosed live in the run log, never silently empty. 'Following' is unaffected. Default: `["videos"]` | `["videos", "user_info"]` | | `maxUserResults` | No | Integer (minimum 1) | Maximum items to fetch per profile / section. Ignored when 'Scrape all available results' is enabled. The data source naturally returns at least ~40 items per fetch on paid plans. Free plan: up to 20 items per run (all input entries and categories together) and 200 per month; paid plans have no limit. Default: `10` | `25` | | `scrapeAllUserResults` | No | Boolean | Ignore the limit above and collect everything available for each profile. Default: `false` | `false` | | `videoUrlsComments` | No | Array of String | TikTok video URLs or IDs to scrape comments from. | `["https://www.tiktok.com/@taylorswift/video/7123456789012345678"]` | | `commentsPerUrl` | No | Integer (minimum 1) | Maximum comments per video. Ignored when 'Scrape all comments' is on. Same free-plan cap as above. Default: `10` | `50` | | `scrapeAllComments` | No | Boolean | Collect every available comment per video (slower, more usage). Default: `false` | `false` | | `repliesPerComment` | No | Integer (minimum 0) | Maximum replies per comment. Set to 0 to skip replies entirely. Ignored when 'Scrape all replies' is on. Replies also count toward the free-plan 20-items-per-run cap. Default: `0` | `5` | | `scrapeAllReplies` | No | Boolean | Collect every available reply for each comment (slower, more usage). Default: `false` | `false` | | `hashtags` | No | Array of String | TikTok hashtag names or URLs to scrape videos from. | `["dance"]` | | `videosPerHashtag` | No | Integer (minimum 1) | Maximum videos per hashtag. Ignored when 'Scrape all hashtag videos' is on. Same free-plan cap as above. Default: `10` | `20` | | `scrapeAllHashtagVideos` | No | Boolean | Collect every available video for each hashtag (slower, more usage). Default: `false` | `false` | | `hashtagRegion` | No | String (pattern: two letters) | Two-letter country code used for localization (e.g. US, GB, IN). Default: `"US"` | `"US"` | | `musicUrls` | No | Array of String | TikTok music URLs or IDs to scrape videos from. | `[]` | | `videosPerMusic` | No | Integer (minimum 1) | Maximum videos per music track. Ignored when 'Scrape all music videos' is on. Same free-plan cap as above. Default: `10` | `10` | | `scrapeAllMusicVideos` | No | Boolean | Collect every available video for each music track (slower, more usage). Default: `false` | `false` | | `playlistIDs` | No | Array of String | TikTok playlist IDs to scrape videos from. | `[]` | | `videosPerPlaylist` | No | Integer (minimum 1) | Maximum videos per playlist. Ignored when 'Scrape all playlist videos' is on. Same free-plan cap as above. Default: `10` | `10` | | `scrapeAllPlaylistVideos` | No | Boolean | Collect every available video for each playlist (slower, more usage). Default: `false` | `false` | | `videoDetailsList` | No | Array of String | TikTok video IDs or URLs to retrieve full details for. Each entry produces one record; counts toward the free plan's 20-items-per-run cap like every other category. | `[]` | | `minRequestInterval` | No | Number (minimum 0, maximum 10) | Seconds to wait between consecutive requests. Lower is faster but more likely to be rate-limited. Default: `1.2` | `1.2` | | `maxRetries` | No | Integer (minimum 0, maximum 10) | How many times to retry a failed/blocked request before giving up. Default: `3` | `3` | | `apiKey` | No | String | Optional key that lifts this Actor's own pacing for faster collection. Leave empty for the standard pacing; unrelated to Apify's free/paid plans. Default: `""` | `""` | | `proxyConfiguration` | No | Object | By default the scraper runs without a proxy. If TikTok blocks the direct connection, it automatically escalates from a datacenter proxy to a residential proxy, then sticks with residential. You can also force a proxy here. Default: `{"useApifyProxy": false}` | `{"useApifyProxy": false}` | #### Free plan limits Free plan: up to 20 items per run (all input entries and categories together) and 200 per month; paid plans have no limit. #### Example input ```json { "userUrls": ["https://www.tiktok.com/@taylorswift"], "categories": ["videos", "user_info"], "maxUserResults": 25, "scrapeAllUserResults": false, "videoUrlsComments": ["https://www.tiktok.com/@taylorswift/video/7123456789012345678"], "commentsPerUrl": 50, "scrapeAllComments": false, "repliesPerComment": 5, "scrapeAllReplies": false, "hashtags": ["dance"], "videosPerHashtag": 20, "scrapeAllHashtagVideos": false, "hashtagRegion": "US", "musicUrls": [], "videosPerMusic": 10, "scrapeAllMusicVideos": false, "playlistIDs": [], "videosPerPlaylist": 10, "scrapeAllPlaylistVideos": false, "videoDetailsList": [], "minRequestInterval": 1.2, "maxRetries": 3, "apiKey": "", "proxyConfiguration": { "useApifyProxy": false } } ``` *** ### โฌ†๏ธ Output ![Output fields of the TikTok Data Scraper](https://api.apify.com/v2/key-value-stores/WYkyEfqs10huyXYxr/records/a-tiktok-data-output.webp) Every result is one typed, normalized JSON item with the same envelope shape on every run, pushed to the dataset live as it's collected โ€” a crash mid-run still keeps whatever was saved so far. Export the dataset as JSON, CSV, Excel, XML, RSS or HTML from the Apify Console or via the API. #### Example output A video record (`section: "users"`, `category: "videos"`): ```json { "section": "users", "category": "videos", "input": "https://www.tiktok.com/@taylorswift", "user": "taylorswift", "userType": "unique_id", "data": { "aweme_id": "7123456789012345678", "video_id": "7123456789012345678", "region": "US", "title": "", "content_desc": "getting ready for the show tonight ๐ŸŽค", "cover": "https://p16-sign.tiktokcdn-us.com/cover1.jpeg", "ai_dynamic_cover": "https://p16-sign.tiktokcdn-us.com/dyncover1.jpeg", "origin_cover": "https://p16-sign.tiktokcdn-us.com/origcover1.jpeg", "duration": 27, "play": "https://v16.tiktokcdn-us.com/play1.mp4", "wmplay": "https://v16.tiktokcdn-us.com/wmplay1.mp4", "size": 3245621, "wm_size": 3401004, "music": "https://sf16.tiktokcdn.com/music1.mp3", "music_info": { "title": "original sound", "author": "taylorswift" }, "play_count": 18234092, "digg_count": 2145092, "comment_count": 38221, "share_count": 91042, "download_count": null, "collect_count": 154022, "create_time": 1737033600, "is_ad": false, "commerce_info": null, "is_nff_or_nr": null, "is_top": 0, "author": { "unique_id": "taylorswift", "nickname": "Taylor Swift", "avatar": "https://p16-sign.tiktokcdn-us.com/avatar1.jpeg" }, "publishedAt": "2025-01-16T12:00:00Z", "scrapedAt": "2026-08-04T09:12:41Z", "videoUrl": "https://www.tiktok.com/@taylorswift/video/7123456789012345678", "profileUrl": "https://www.tiktok.com/@taylorswift" } } ``` A comment record (`section: "videos"`, `category: "comments"`): ```json { "section": "videos", "category": "comments", "input": "https://www.tiktok.com/@taylorswift/video/7123456789012345678", "user": "7123456789012345678", "userType": "video_id", "data": { "id": "7123456790000000001", "text": "this is the best one yet", "digg_count": 4021, "reply_total": 12, "publishedAt": "2025-01-16T13:04:22Z", "user": { "nickname": "swiftie4life", "unique_id": "swiftie4life", "signature": "team taylor since 2008", "region": "US", "verified": false, "follower_count": 812 }, "videoUrl": "https://www.tiktok.com/@taylorswift/video/7123456789012345678", "scrapedAt": "2026-08-04T09:13:05Z" } } ``` A profile record (`section: "users"`, `category: "user_info"`): ```json { "section": "users", "category": "user_info", "input": "https://www.tiktok.com/@taylorswift", "user": "taylorswift", "userType": "unique_id", "data": { "id": "107955", "unique_id": "taylorswift", "nickname": "Taylor Swift", "avatar": "https://p16-sign.tiktokcdn-us.com/avatar-full1.jpeg", "user": { "signature": "๐ŸŽค new music out now", "bioLink": { "link": "taylorswift.com" }, "ins_id": "taylorswift", "twitter_id": "taylorswift13", "youtube_channel_id": null }, "stats": { "followerCount": 9021345, "followingCount": 12, "heartCount": 512034221, "videoCount": 231 }, "profileUrl": "https://www.tiktok.com/@taylorswift", "scrapedAt": "2026-08-04T09:12:10Z" } } ``` *** ### How does it work? TikTok Data Scraper reads the same public pages TikTok's own web app serves to a logged-out visitor viewing a profile, video, hashtag or sound page โ€” no TikTok login, no cookies. Requests go out with a pacing delay between them and are retried with backoff if one is blocked. If a connection is blocked, it escalates automatically through an Apify datacenter proxy and then a residential proxy, and sticks with residential once that engages. Only what TikTok already serves to a logged-out visitor is returned โ€” nothing behind a login wall. The output envelope (`section`, `category`, `input`, `user`, `userType`, `data`) stays the same shape run after run, so a change to TikTok's own page layout does not change your downstream schema. The Actor is maintained, and this schema stability is kept across TikTok's own layout changes. *** ### How do you integrate TikTok Data Scraper into your stack? This Actor works with what you already use: a REST API from any language, MCP for AI agents, and no-code tools. #### MCP integration for AI agents Point your AI assistant at Apify's MCP server and it can read TikTok on its own through this Actor โ€” profiles, videos, comments, hashtags, sounds and playlists โ€” without you writing any scraping logic into your prompts. ```bash claude mcp add --transport http apify "https://mcp.apify.com?tools=socialdataapi/tiktok-data-scraper" ``` This registers it as a tool your agent can call directly. Your assistant finds it through the MCP server's search, add and call-actor tools, with no actor ID hardcoded in your setup. Works with Claude Code, Cursor and Windsurf. #### No-code tools (n8n, Make, LangChain) In n8n, use the Apify node's "Run an Actor" action, or the HTTP Request node pointed at the run-sync endpoint with your Apify token. In Make, use the Apify app's "Run an Actor" module followed by "Get Dataset Items". In LangChain, use `langchain-apify` and wrap this actor with `ApifyActorsTool()` once it is in your account, so an agent can request fresh TikTok data mid-conversation instead of relying on stale training data. *** ### Is it legal to scrape TikTok data? Scraping publicly available data โ€” data anyone can see without logging in โ€” is generally lawful. It returns only publicly available data: what any visitor sees without an account. The personal data mixed into TikTok profiles and comments (usernames, bios, follower counts, commenter identities) brings data-protection law into play once you store or use it: GDPR (EU/UK) and similar laws may require a lawful basis and a retention policy. Scraping also remains subject to TikTok's own Terms of Service. Consult legal counsel if your use case involves bulk storage of personal data. *** ### Frequently asked questions #### What fields does TikTok Data Scraper return? The top fields are play count, like count, comment count, follower count and the video caption/description, alongside dozens more depending on category โ€” see [the data fields section](#what-data-can-i-extract-with-tiktok-data-scraper) above for the full breakdown. #### Does TikTok Data Scraper require a TikTok account or login? No. The Actor reads only public TikTok data and needs no TikTok credentials. The optional `apiKey` input field is this Actor's own premium key for lifting its internal pacing โ€” it is unrelated to your TikTok account or to Apify's free/paid plans. #### What happens if a profile, video, hashtag or sound is private, deleted, or doesn't exist? The Actor logs a warning and skips that specific input โ€” no record is pushed for it, and it is not charged. Other profiles, videos, hashtags, music or playlists queued in the same run are processed normally and unaffected. #### Can I scrape multiple TikTok profiles, videos, hashtags, sounds or playlists at once? Yes โ€” `userUrls`, `videoUrlsComments`, `hashtags`, `musicUrls`, `playlistIDs` and `videoDetailsList` are all arrays, so a single run can queue any number of each, and queued inputs are processed concurrently rather than strictly one at a time. #### Does TikTok Data Scraper work with Claude, ChatGPT and other AI agent tools? Yes โ€” TikTok Data Scraper is available as an MCP tool. Add Apify's MCP server (`claude mcp add --transport http apify "https://mcp.apify.com?tools=socialdataapi/tiktok-data-scraper"`) in Claude Code, Cursor or Windsurf, and your agent can find and call this Actor on its own. Any agent that can call an HTTP endpoint can also use the REST API directly. #### Does TikTok Data Scraper return data in a format LLMs can use directly? Yes. Every record is typed, normalized JSON with consistent field names across runs โ€” no HTML, no CSS selectors. Pass it straight to an LLM prompt, index it into a vector store, or hand it to an agent tool. #### What happens when TikTok changes its layout or anti-bot system? The Actor is maintained, and its output schema is designed to stay stable across TikTok's changes โ€” your calls keep returning the same JSON schema with no changes on your end. It already includes an automatic proxy-escalation ladder and a secondary public-listing fallback to survive one class of upstream block. #### Can I use TikTok Data Scraper without managing proxies or browser infrastructure? Yes. It runs with no proxy at all by default and only escalates to Apify's datacenter and then residential proxies if TikTok blocks the direct connection โ€” no browser is involved. You never have to configure any of this yourself, though `proxyConfiguration` lets you override it. #### Which TikTok fields work best for AI training data and RAG indexing? For RAG, index the text-rich fields: the video caption and description, the profile bio, and comment text. For structured training features, use the numeric fields: play count, like count, comment count, share count and follower count. All fields return as typed primitives (strings, integers, booleans), not embedded HTML. *** ### Related scrapers | Scraper | What it extracts | | --- | --- | | TikTok Profile Scraper | Public TikTok creator profiles by username, one row per video with views, likes, comments, shares and video metadata | | TikTok Trending Hashtags Scraper | TikTok's trending-hashtag feed, discovered without needing a specific hashtag name | | Tiktok Trending Hashtags Analytics Scraper | TikTok Creative Center trending-hashtag analytics by country and time window โ€” rank, views, posts and top creators | | TikTok Video Scraper | A single TikTok video or photo post by link, with full post detail | *** ### Your feedback Found a bug, or need a TikTok field this Actor doesn't return yet? Open an issue from the Actor's Issues tab on its Apify Store page, or message the developer through Apify Console โ€” reports like these directly shape what ships in the next update. # Changelog This Actor's version history is a separate document: https://apify.com/socialdataapi/tiktok-data-scraper/changelog.md # Actor input Schema ## `userUrls` (type: `array`): One or more profiles. Examples: https://www.tiktok.com/@taylorswift ยท taylorswift ยท @taylorswift ยท 107955 ## `categories` (type: `array`): Pick which kinds of content to collect for each profile above. Multiple selections are supported. Note: 'Followers' always returns 0 results โ€” TikTok does not expose a public followers list to guests for any account, a confirmed platform limitation disclosed live in the run log. 'Following' is unaffected. ## `maxUserResults` (type: `integer`): Maximum items to fetch per profile / section. Ignored when 'Scrape all results' is enabled. The data source naturally returns at least ~40 items per fetch on paid plans, so values below 40 are not guaranteed to shrink usage there. Free plan: up to 20 items per run (all input entries and categories together) and 200 per month; paid plans have no limit. ## `scrapeAllUserResults` (type: `boolean`): Ignore the limit above and collect everything available for each profile. ## `videoUrlsComments` (type: `array`): TikTok video URLs or IDs to scrape comments from. ## `commentsPerUrl` (type: `integer`): Maximum comments per video. Ignored when 'Scrape all comments' is on. The data source naturally returns at least ~40 comments per fetch on paid plans. Free plan: up to 20 items per run (all input entries and categories together) and 200 per month; paid plans have no limit. ## `scrapeAllComments` (type: `boolean`): Collect every available comment per video (slower, more usage). ## `repliesPerComment` (type: `integer`): Maximum replies per comment. Set to 0 to skip replies entirely. Ignored when 'Scrape all replies' is on. Replies also count toward the free-plan 20-items-per-run cap described above. ## `scrapeAllReplies` (type: `boolean`): Collect every available reply for each comment (slower, more usage). ## `hashtags` (type: `array`): TikTok hashtag names or URLs to scrape videos from. ## `videosPerHashtag` (type: `integer`): Maximum videos per hashtag. Ignored when 'Scrape all hashtag videos' is on. The data source naturally returns at least ~40 items per fetch on paid plans. Free plan: up to 20 items per run (all input entries and categories together) and 200 per month; paid plans have no limit. ## `scrapeAllHashtagVideos` (type: `boolean`): Collect every available video for each hashtag (slower, more usage). ## `hashtagRegion` (type: `string`): Two-letter country code used for localization (e.g. US, GB, IN). ## `musicUrls` (type: `array`): TikTok music URLs or IDs to scrape videos from. ## `videosPerMusic` (type: `integer`): Maximum videos per music track. Ignored when 'Scrape all music videos' is on. The data source naturally returns at least ~40 items per fetch on paid plans. Free plan: up to 20 items per run (all input entries and categories together) and 200 per month; paid plans have no limit. ## `scrapeAllMusicVideos` (type: `boolean`): Collect every available video for each music track (slower, more usage). ## `playlistIDs` (type: `array`): TikTok playlist IDs to scrape videos from. ## `videosPerPlaylist` (type: `integer`): Maximum videos per playlist. Ignored when 'Scrape all playlist videos' is on. The data source naturally returns at least ~40 items per fetch on paid plans. Free plan: up to 20 items per run (all input entries and categories together) and 200 per month; paid plans have no limit. ## `scrapeAllPlaylistVideos` (type: `boolean`): Collect every available video for each playlist (slower, more usage). ## `videoDetailsList` (type: `array`): TikTok video IDs or URLs to retrieve full details for. ## `minRequestInterval` (type: `number`): Seconds to wait between consecutive requests. Lower is faster but more likely to be rate-limited. ## `maxRetries` (type: `integer`): How many times to retry a failed/blocked request before giving up. ## `apiKey` (type: `string`): Optional key that lifts this Actor's own pacing for faster collection. Leave empty for the standard pacing. Unrelated to Apify's free/paid plans or the free-plan item limits described above. ## `proxyConfiguration` (type: `object`): By default the scraper runs without a proxy. If TikTok blocks the direct connection, it automatically escalates from a datacenter proxy to a residential proxy, then sticks with residential. You can also force a proxy here. ## Actor input object example ```json { "userUrls": [ "https://www.tiktok.com/@taylorswift" ], "categories": [ "videos" ], "maxUserResults": 10, "scrapeAllUserResults": false, "commentsPerUrl": 10, "scrapeAllComments": false, "repliesPerComment": 0, "scrapeAllReplies": false, "videosPerHashtag": 10, "scrapeAllHashtagVideos": false, "hashtagRegion": "US", "videosPerMusic": 10, "scrapeAllMusicVideos": false, "videosPerPlaylist": 10, "scrapeAllPlaylistVideos": false, "minRequestInterval": 1.2, "maxRetries": 3, "apiKey": "", "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): All scraped items across every category (users, videos, comments, replies, hashtags, music, playlists, video details), overview columns. ## `videos` (type: `string`): Video records (user videos, favourites, search results, hashtag/music/playlist videos, single-video details) with stats, cover images and canonical URLs. ## `comments` (type: `string`): Video comments and their replies, with the commenting user's profile info and the source video URL. ## `users` (type: `string`): Profile info, following and followers records, with bio, social links and follower/heart/video stats. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "userUrls": [ "https://www.tiktok.com/@taylorswift" ] }; // Run the Actor and wait for it to finish const run = await client.actor("socialdataapi/tiktok-data-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "userUrls": ["https://www.tiktok.com/@taylorswift"] } # Run the Actor and wait for it to finish run = client.actor("socialdataapi/tiktok-data-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "userUrls": [ "https://www.tiktok.com/@taylorswift" ] }' | apify call socialdataapi/tiktok-data-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,socialdataapi/tiktok-data-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/tAR1BXP0MxfvmRyL7/builds/5gPY8FhvgrYKqIUdE/openapi.json