Tiktok Comments Scraper

Tiktok Comments Scraper

Tiktok Comments Scraper is a production-ready Apify actor that extracts structured comments (and optional replies) from TikTok videos at scale — by direct video URLs or by discovering videos from profiles. It solves the pain of manually collecting comment text, likes, replies, timestamps, and user info, acting as a reliable TikTok comments API alternative for marketers, developers, analysts, and researchers. Run bulk jobs, export TikTok comments to CSV/JSON, and operationalize social listening, UGC mining, sentiment analysis, and competitor tracking across campaigns.

What is Tiktok Comments Scraper?

Tiktok Comments Scraper is a TikTok video comments scraper that collects comment-level data (text, likes, timestamps, mentions, and user identifiers) and, optionally, replies. It helps you scrape TikTok comments by video URL or discover videos from profiles (including reposts) and then download TikTok comments in clean, structured formats for analysis or automation. Built for social teams, data analysts, researchers, and engineers, it enables repeatable comment extraction pipelines at scale with robust proxy handling and retry logic.

What data / output can you get?

Data type	Description	Example value
videoWebUrl	Canonical video URL after resolving redirects	https://www.tiktok.com/@mrbeast/video/7578547467189374239
submittedVideoUrl	The resolved URL used for scraping (same as videoWebUrl)	https://www.tiktok.com/@mrbeast/video/7578547467189374239
input	The original URL provided in input	https://www.tiktok.com/@mrbeast/video/7578547467189374239
cid	Comment ID	7578605549794034443
createTime	Unix timestamp (seconds) when the comment was created	1732995615
createTimeISO	ISO timestamp of comment creation	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 author liked the comment (from TikTok API)	false
pinnedByAuthor	Whether the comment was pinned by the author	false
repliesToId	Parent comment ID for a reply; null for top-level comments	null
replyCommentTotal	Total number of replies reported by TikTok for this comment	100
uid	Commenter’s user ID	7516601022924489733
uniqueId	Commenter’s username (unique ID)	amin.hrizi4
avatarThumbnail	Commenter’s avatar thumbnail URL	https://p16-sign-va.tiktokcdn.com/...
mentions	Array of @mentions parsed from text	[]
detailedMentions	Structured mention entities from text_extra/text	[]
replies	Array of reply objects (same shape as comments, without nested replies)	[]

Notes:

• You can export results from the Apify dataset in JSON or CSV.
• The actor also stores the full array in the key-value store as output.json.
• Replies are included only if maxRepliesPerComment > 0.

Key features

• 🔁 Smart proxy fallback and retries The built-in Proxy Manager starts with no proxy, then falls back to datacenter, then residential with up to 3 retries — and sticks to residential once successful. Clear log events show each proxy stage.

• 📥 Two input modes: video URLs or profiles Scrape TikTok comments directly with postURLs, or discover videos from profiles (videos and/or reposts) and then crawl their comments. Ideal for campaign-wide or competitor monitoring.

• 🧭 Profile discovery with sorting and filters For profiles, choose profileScrapeSections (videos, reposts), profileSorting (latest, oldest, popular), date filters (oldestPostDateUnified, newestPostDate), and excludePinnedPosts for clean targeting.

• 💬 Replies collection (per comment) Set maxRepliesPerComment to fetch nested replies for richer context and threaded conversation analysis in your TikTok comments crawler.

• 🏷️ Mentions extraction Automatically extracts mentions from both the comment text and TikTok’s text_extra metadata into mentions and detailedMentions arrays.

• ⚡ Fast, parallelized scraping Processes multiple videos concurrently for speed and throughput, helping you download TikTok comments at scale.

• 🧪 Playwright-backed profile capture Uses a headless browser to intercept /api/ responses for profiles/reposts when HTTP-only endpoints return empty lists on cloud runs. Optional cookie support via TIKTOK_SID_TT for reliability on reposts.

• 📊 Structured, analytics-ready output Clean schema with text, diggCount, replyCommentTotal, createTimeISO, uniqueId, and more — perfect for dashboards and NLP pipelines.

• 📦 Easy exports Export TikTok comments to CSV or JSON from the Apify dataset. Consume results programmatically via Apify API in your TikTok comment scraper Python workflow.

How to use Tiktok Comments Scraper - step by step

1. Sign in to Apify

• Go to console.apify.com and log in.

2. Open the actor

• Find “tiktok-comments-scraper” and click “Run”.

3. Choose your input mode

• Option A — Direct URLs: Add TikTok video URLs in postURLs.
• Option B — Profiles: Add usernames (without @) in profiles. The actor will discover videos from the selected sections.

4. Configure scope and discovery

• commentsPerPost: Max number of comments to pull per video.
• maxRepliesPerComment: How many replies to include per comment (0 to skip).
• resultsPerPage: Number of videos to collect per profile.
• profileScrapeSections: Choose videos and/or reposts.
• profileSorting: latest, oldest, or popular.
• Filters: oldestPostDateUnified and newestPostDate (absolute dates or relative like “5 days”).
• excludePinnedPosts: Toggle to skip pinned content on profiles.

5. Set proxy configuration

• proxyConfiguration: Start with no proxy by default; the actor automatically falls back to datacenter and then residential if blocked (logged as PROXY EVENTs).
• Optional: For Playwright-based profile/reposts reliability, you may set the TIKTOK_SID_TT cookie via environment variable in your Apify run settings if needed.

6. Run and monitor

• Click “Start”. Track live logs including PROXY EVENT lines and progress (video counts, saved items).

7. Download results

• Go to the Dataset tab to export JSON or CSV. The full JSON array is also saved as output.json in the key-value store.

Pro Tip: Use profiles to build a repeatable social listening pipeline — discover the latest videos from key accounts, then capture their comments at a set cadence using the Apify API and pipe results into your analytics stack.

Use cases

Use case	Description
Social listening & sentiment tracking	Aggregate comments at scale to gauge audience sentiment and detect themes across creators or campaigns.
Competitor analysis	Monitor comments on competitors’ videos to surface objections, FAQs, and real user feedback.
UGC discovery & research	Identify engaging TikTok user comments and replies to inform creative direction and community features.
Content testing & optimization	Compare comment diggCount and replyCommentTotal across videos to refine messaging and hooks.
Crisis monitoring & PR	Track spikes in comment volume and topics around key announcements or incidents.
Academic & NLP pipelines	Feed structured comments into topic modeling, entity extraction, and sentiment classification.
Marketing performance reporting	Export TikTok comments to CSV for dashboards that combine video stats and comment engagement.
Automation & data engineering	Treat it as a TikTok comments API alternative via Apify API; trigger runs, fetch datasets, and load to your warehouse.

Why choose Tiktok Comments Scraper?

• 🎯 Precision data model: Comment text, likes, timestamps (Unix and ISO), mentions, user IDs, reply counts, and optional replies in one schema.
• 🧰 Reliable infrastructure: Automatic proxy fallback (no proxy → datacenter → residential) with retries and sticky residential once successful.
• 🧪 Browser-assisted discovery: Playwright intercepts /api/ responses for robust profile video/repost discovery on cloud.
• 🧩 Developer-friendly: Access datasets programmatically, integrate with your TikTok comment scraper Python workflows, or use the Apify REST API.
• 📈 Built for scale: Parallelized processing to handle bulk inputs and campaigns across multiple profiles and videos.
• 🔐 Public-source focus: Designed for publicly available content; optional cookie support (TIKTOK_SID_TT) when necessary for repost tabs.
• 💾 Clean exports: Download TikTok comments to JSON or CSV – analytics-ready with no extra cleanup.

Bottom line: a robust TikTok comments scraper tool that outperforms one-off scripts or a TikTok comments scraper Chrome extension by providing repeatable, production-grade runs and structured outputs.

Is it legal / ethical to use Tiktok Comments Scraper?

Yes — when done responsibly. This actor collects data from publicly available sources only and does not access private accounts or password-protected content. You are responsible for ensuring lawful use of the data (e.g., GDPR/CCPA, privacy, anti-spam), and for respecting TikTok’s Terms of Service and rate limits. Always consult your legal team for edge cases and jurisdiction-specific requirements.

Input parameters & output format

Example JSON input

{
  "postURLs": [
    "https://www.tiktok.com/@mrbeast/video/7578547467189374239"
  ],
  "commentsPerPost": 100,
  "maxRepliesPerComment": 2,
  "profiles": ["mrbeast"],
  "resultsPerPage": 30,
  "profileScrapeSections": ["videos", "reposts"],
  "profileSorting": "latest",
  "oldestPostDateUnified": null,
  "newestPostDate": null,
  "excludePinnedPosts": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Parameters

Field	Type	Description	Default	Required
postURLs	array	TikTok video URLs to extract comments from. If provided, takes priority over profiles.	—	No
commentsPerPost	integer	Max comments per video; actual count may vary due to TikTok limitations. Minimum 1.	100	No
maxRepliesPerComment	integer	Max replies to fetch per comment. Successful extraction of all replies is not guaranteed. Minimum 0.	3	No
profiles	array	TikTok usernames (without @) to discover videos from.	—	No
resultsPerPage	integer	Number of videos per profile to scrape (1–1,000,000).	10	No
profileScrapeSections	array (enum: videos, reposts)	Profile sections to scrape (supports reposts).	["videos"]	No
profileSorting	string (enum: latest, popular, oldest)	Sorting for profile video discovery. Date filters apply to latest/oldest.	latest	No
oldestPostDateUnified	string	Only include profile videos after/on this date. Absolute (YYYY-MM-DD) or relative (e.g., 5 days, 2 weeks).	—	No
newestPostDate	string	Only include profile videos before/on this date. Absolute (YYYY-MM-DD) or relative (e.g., 5 days, 2 weeks).	—	No
excludePinnedPosts	boolean	Exclude pinned posts from profiles.	false	No
proxyConfiguration	object	Choose proxies. If blocked, fallback to datacenter then residential with 3 retries.	{"useApifyProxy": false}	No

Important: Provide at least one of postURLs or profiles; otherwise there’s nothing to process.

Example JSON output

[
  {
    "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:

• reply objects share the same shape as comments except they do not contain a nested replies array.
• mentions/detailedMentions arrays may be empty when no @users are present.

FAQ

Do I need to provide video URLs, or can it discover videos from profiles?

You can do either. Provide postURLs to scrape TikTok comments by video URL, or add profiles to discover videos from profile pages (videos and/or reposts) using Playwright-backed capture. If both are provided, postURLs take priority.

How many comments can it collect per video?

You control this with commentsPerPost. The actor requests comments in pages (up to your limit). Actual counts can vary based on TikTok’s API responses and availability.

Can it collect replies to comments?

Yes. Set maxRepliesPerComment to a positive integer to fetch replies. The scraper records replyCommentTotal and includes the replies array, subject to TikTok response limits.

How does it avoid blocks?

It starts with no proxy, falls back to datacenter if blocked, and then to residential with up to 3 retries. Once residential succeeds, it sticks to residential for the rest of the run. All proxy events are logged.

Does it work for reposts or popular videos on profiles?

Yes. Use profileScrapeSections to include reposts and profileSorting to choose latest, oldest, or popular. Date filters (oldestPostDateUnified/newestPostDate) apply to latest/oldest.

Can I export the data to CSV?

Yes. Open the run’s Dataset and export to JSON or CSV. The actor also stores a full array as output.json in the key-value store for convenience.

Is this a TikTok comments scraper tool I can automate with Python?

Yes. You can run the actor and fetch datasets via the Apify API from your Python code, making it a practical TikTok comment scraper Python workflow and TikTok comments API alternative.

Does it require login?

No login is required for public data. For some profile/repost scenarios, you can optionally add a TikTok cookie (TIKTOK_SID_TT) via environment variables to improve reliability in Playwright capture.

Closing CTA / Final thoughts

Tiktok Comments Scraper is built for structured, scalable extraction of TikTok video comments and replies. With robust proxy fallback, Playwright-backed profile discovery, and clean JSON/CSV outputs, it’s ideal for marketers, developers, analysts, and researchers who need a dependable TikTok comments scraper online. Run it via the Apify console or API, integrate with your pipelines, and start turning unstructured threads into actionable insights.