Tiktok Comments Scraper

Tiktok Comments Scraper

Tiktok Comments Scraper is a production-ready TikTok comment scraper tool that lets you scrape TikTok video comments at scale — complete with timestamps, commenter details, like counts, mentions, and optional replies. It solves the pain of collecting clean, structured TikTok comments JSON from public posts and can also discover videos from profiles (videos or reposts) before scraping. Built for marketers, developers, analysts, and researchers, this TikTok comments extractor enables bulk extract TikTok comments workflows and downstream analysis with CSV/JSON exports. 🚀

What is Tiktok Comments Scraper?

Tiktok Comments Scraper is a scalable TikTok comment crawler that extracts structured comments (and optional replies) from TikTok videos. It addresses the challenge of gathering clean, timestamped comment data with user info and mentions — a reliable TikTok comments API alternative that outputs JSON. For marketers, developers, data analysts, and researchers, it powers automated pipelines to download TikTok comments, perform TikTok comment sentiment analysis, and export TikTok comments to CSV for reporting at scale.

What data / output can you get?

Below are the exact fields the actor pushes to the Apify Dataset for each comment (replies share the same shape, without a nested replies array):

Data field	Description	Example value
videoWebUrl	Canonical web URL of the TikTok video	https://www.tiktok.com/@mrbeast/video/7578547467189374239
submittedVideoUrl	Submitted/canonical URL for traceability (same as videoWebUrl)	https://www.tiktok.com/@mrbeast/video/7578547467189374239
input	The original input URL used for scraping	https://www.tiktok.com/@mrbeast/video/7578547467189374239
cid	Comment ID	7578605549794034443
createTime	Comment creation time (unix seconds)	1732995615
createTimeISO	Comment creation time (ISO)	2025-11-30T19:40:15.000Z
text	Comment text content	mr beast are you ok ?
diggCount	Number of likes on the comment	7633
likedByAuthor	Whether the video author liked the comment	false
pinnedByAuthor	Whether the video author pinned the comment	false
repliesToId	Parent comment ID (null for top-level comments)	null
replyCommentTotal	Reply count reported by TikTok	100
uid	Commenter numeric user ID	7516601022924489733
uniqueId	Commenter username	amin.hrizi4
avatarThumbnail	URL to commenter’s avatar thumbnail	https://p16-sign-va.tiktokcdn.com/...
mentions	Flat list of @mentions parsed from text	[]
detailedMentions	Structured mention ranges and IDs	[]
replies	Array of reply objects (same shape as comments, without nested replies)	[]

Notes:

• Replies are included as an array inside their parent comment, with the same fields (excluding the nested replies array).
• Results are pushed as individual records to the Apify Dataset and also saved as a full JSON array to the key‑value store under output.json. From the Dataset, you can export TikTok comments to CSV or JSON for integration and reporting.

Key features

• 🚀 Bulk video inputs & profile discovery
  Feed multiple postURLs directly or discover videos from profiles using profileScrapeSections ("videos" or "reposts"), profileSorting ("latest", "popular", "oldest"), and date filters.

• 🧵 Replies with limits
  Capture top-level comments and optionally fetch replies per comment with maxRepliesPerComment for efficient, targeted extraction.

• ⏱️ Timestamps & mentions extraction
  Download TikTok comments with createTime and createTimeISO, and parse @mentions from both text and text_extra for richer analytics.

• 🧠 Smart proxy fallback (no API required)
  Built-in Proxy Manager starts with no proxy, falls back to datacenter, then residential with up to 3 retries — a robust TikTok comments scraper no API approach.

• ⚖️ High concurrency & resilient requests
  Async pipeline with retries, cursor pagination, and semaphores delivers reliable, large-scale TikTok comments dataset creation.

• 📦 Structured JSON output
  Clean, machine-readable objects with commenter info, engagement metrics, mentions, and flattened replies — ideal for analytics pipelines.

• 🧰 Developer-friendly, Python-based
  Implemented with the Apify SDK. Access results via the Dataset API for seamless TikTok comment scraper Python workflows.

How to use Tiktok Comments Scraper - step by step

1. Sign in to Apify Console and open the Tiktok Comments Scraper actor.
2. Choose your source:
   • To scrape TikTok comments from specific videos, paste one or more full video URLs into postURLs.
   • To discover videos from profiles, add usernames (without @) to profiles.
3. Configure profile discovery (if using profiles):
   • resultsPerPage: how many videos per profile to collect.
   • profileScrapeSections: select "videos" and/or "reposts".
   • profileSorting: choose "latest", "popular", or "oldest".
   • Optional date filters: oldestPostDateUnified and newestPostDate (absolute YYYY-MM-DD or relative like “5 days”, “2 weeks”).
   • excludePinnedPosts to skip pinned content.
4. Set scraping depth:
   • commentsPerPost: maximum number of comments to extract per video.
   • maxRepliesPerComment: number of replies to fetch per comment (0 to skip replies).
5. Configure proxyConfiguration if needed:
   • The run starts with no proxy. On blocks, it falls back to datacenter, then residential with up to 3 retries, and stays “sticky” on residential thereafter.
6. Run the actor and monitor logs:
   • Look for “PROXY EVENT” messages and per-video progress (e.g., Saved X comments).
7. Access results:
   • View structured records in the Dataset. A full JSON array is also saved to the key‑value store as output.json.
8. Export and integrate:
   • Export from the Dataset to JSON or CSV for BI tools and workflow automation.

Pro Tip: Trigger runs via the Apify API and pipe the Dataset to your warehouse or automation stack (n8n, Make, Zapier) to build a repeatable TikTok comments export toolchain.

Use cases

Use case	Description
Social media analysis	Aggregate and analyze engagement across videos; track themes with mentions and timestamps for TikTok comment analysis.
Content research	Understand audience reactions to creators and campaigns by extracting TikTok video comments with optional replies.
Market research	Measure responses to branded content without relying on a TikTok comments API; build a TikTok comments dataset.
Trend tracking	Monitor topics over time via profile-based discovery (videos/reposts) and scrape TikTok comments consistently.
Community monitoring	Continuously collect feedback and detect issues by crawling comments for selected profiles or posts.
Data enrichment (API)	Feed structured comment objects into analytics pipelines through the Apify Dataset API for modeling.
Academic research	Build datasets of public discourse with timestamps and user metadata for quantitative studies.

Why choose Tiktok Comments Scraper?

This tool focuses on reliability, structure, and scale — a dependable TikTok comment scraper tool for production workflows.

• ✅ Accurate, structured records: Text, timestamps, counts, mentions, and commenter identifiers for analysis-ready datasets.
• 🌐 Profile-based discovery: Discover videos via “videos”/“reposts” with sorting and date filters to scrape TikTok comments at scale.
• 📈 Built for scale: Concurrency, retries, and pagination for efficient bulk extract TikTok comments operations.
• 🧩 Developer access: JSON records in the Apify Dataset and a full output.json for easy API consumption and Python integration.
• 🛡️ Resilient proxy strategy: Automatic fallback from no proxy → datacenter → residential (with retries) when blocked.
• 🧱 Cloud-native stability: More reliable than browser extensions and unstable scripts; designed for long-running jobs with clear logging.

In short, it’s a robust TikTok comments extractor that outperforms one-off scripts — ideal for teams that need consistent TikTok comments JSON exports.

Is it legal / ethical to use Tiktok Comments Scraper?

Yes — when done responsibly. This actor collects data from publicly available TikTok pages and does not access private or password‑protected content. You are responsible for:

• Scraping only public data and respecting platform terms.
• Ensuring compliance with applicable regulations (e.g., GDPR, CCPA).
• Using the data ethically (e.g., no spam or misuse of personal information).

If you operate in a regulated industry or jurisdiction, consult your legal team to confirm compliance.

Input parameters & output format

Example input JSON

{
  "postURLs": [
    "https://www.tiktok.com/@mrbeast/video/7578547467189374239"
  ],
  "commentsPerPost": 100,
  "maxRepliesPerComment": 3,
  "profiles": ["mrbeast"],
  "resultsPerPage": 10,
  "profileScrapeSections": ["videos"],
  "profileSorting": "latest",
  "oldestPostDateUnified": "2 weeks",
  "newestPostDate": "2025-12-01",
  "excludePinnedPosts": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Parameters

Field	Type	Required	Default	Description
postURLs	array of strings	No	—	TikTok video URLs to extract comments from. If provided, these take priority over profiles.
commentsPerPost	integer	No	100	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.
maxRepliesPerComment	integer	No	3	The maximum number of replies you want from a single comment. Note: Successful extraction of all desired replies is currently not guaranteed.
profiles	array of strings	No	—	TikTok usernames (without @) to scrape videos from (profile-based discovery).
resultsPerPage	integer	No	10	Number of videos you want to scrape per profile (min 1, max 1,000,000).
profileScrapeSections	array of strings	No	["videos"]	Profile sections to scrape: "videos" and/or "reposts".
profileSorting	string	No	"latest"	Profile video sorting: "latest", "popular", or "oldest". Date filters only work with "latest" and "oldest".
oldestPostDateUnified	string	No	—	Optional filter. Only videos uploaded after or on this date will be scraped. Supports absolute (YYYY‑MM‑DD) or relative (e.g., “5 days”, “2 weeks”).
newestPostDate	string	No	—	Optional filter. Only videos uploaded before or on this date will be scraped. Supports absolute (YYYY‑MM‑DD) or relative (e.g., “5 days”, “2 weeks”).
excludePinnedPosts	boolean	No	false	Tick to exclude pinned posts from profiles.
proxyConfiguration	object	No	{"useApifyProxy": false}	Choose which proxies to use. If TikTok rejects the request, it will automatically fallback to datacenter proxy, then residential proxy with 3 retries.

Example output JSON (Dataset record)

{
  "videoWebUrl": "https://www.tiktok.com/@mrbeast/video/7578547467189374239",
  "submittedVideoUrl": "https://www.tiktok.com/@mrbeast/video/7578547467189374239",
  "input": "https://www.tiktok.com/@mrbeast/video/7578547467189374239",
  "cid": "7578605549794034443",
  "createTime": 1732995615,
  "createTimeISO": "2025-11-30T19:40:15.000Z",
  "text": "mr beast are you ok ?",
  "diggCount": 7633,
  "likedByAuthor": false,
  "pinnedByAuthor": false,
  "repliesToId": null,
  "replyCommentTotal": 100,
  "uid": "7516601022924489733",
  "uniqueId": "amin.hrizi4",
  "avatarThumbnail": "https://p16-sign-va.tiktokcdn.com/...",
  "mentions": [],
  "detailedMentions": [],
  "replies": []
}

Notes:

• Replies are returned as an array of objects with the same fields (excluding the nested replies array).
• A full array of all comments is also written to the key‑value store at output.json.

FAQ

How many comments can I scrape per video?

Set commentsPerPost to your desired limit. The actor fetches up to that maximum per video, subject to TikTok’s API and pagination behavior.

Can I scrape comments from multiple videos at once?

Yes. Add multiple URLs to postURLs and the actor will process them in one run. This makes it a practical TikTok comments export tool for batch jobs.

Can it also get replies to comments?

Yes. Set maxRepliesPerComment to a value greater than 0 to fetch replies for each comment (up to your limit). Reply objects include timestamps, text, and commenter info.

What happens if TikTok blocks requests?

The actor uses an automatic proxy fallback: it starts with no proxy, then switches to a datacenter proxy, and finally to a residential proxy with up to 3 retries. Once on residential, it stays there for remaining requests.

Does it support scraping by profile instead of specific URLs?

Yes. Provide usernames in profiles and configure resultsPerPage, profileScrapeSections ("videos", "reposts"), profileSorting, and optional date filters to discover videos before scraping comments.

Is this a TikTok comments API alternative?

Yes. It’s a TikTok comments scraper — no official API required — that outputs structured JSON you can integrate into pipelines or analyze directly.

Can I export results to CSV?

Yes. Results are stored in the Apify Dataset as JSON records. From there, you can export to CSV or JSON and integrate with analytics tools.

Is login or a browser extension required?

No. This is a cloud-based TikTok comments extractor — no TikTok comment scraper Chrome extension or login is required for public content.

Closing CTA / Final thoughts

Tiktok Comments Scraper is built for accurate, scalable extraction of TikTok video comments and replies. With profile-based video discovery, structured JSON output, and resilient proxy handling, it’s ideal for marketers, developers, analysts, and researchers who need a dependable TikTok comment crawler. Run it on Apify to scrape TikTok comments, download TikTok comments with timestamps, and export data to your analytics stack. Developers can access the Dataset via API for a streamlined TikTok comment scraper Python workflow and automation. Start extracting smarter, structured insights from TikTok today.