Tiktok Comments Scraper

Tiktok Comments Scraper

Tiktok Comments Scraper is a production-ready Apify actor that lets you scrape TikTok video comments at scale — including text, likes, replies, timestamps, mentions, and commenter details — and export clean datasets for analysis. Built as a reliable tiktok comment extractor for marketers, developers, data analysts, and researchers, it supports both direct video URLs and profile-based discovery with sorting and date filters. Use it to scrape TikTok video comments, download TikTok comments, and power social listening, UGC mining, and trend analysis at scale.

What data / output can you get?

Below are the exact JSON fields the actor pushes to the dataset for each comment or reply. Export your tiktok comments dataset to JSON or CSV in one click.

Data field	Description	Example
videoWebUrl	Canonical URL of the TikTok video	https://www.tiktok.com/@mrbeast/video/7578547467189374239
submittedVideoUrl	Same as videoWebUrl; the canonical URL resolved from the input	https://www.tiktok.com/@mrbeast/video/7578547467189374239
input	The original input URL used to start scraping	https://www.tiktok.com/@mrbeast/video/7578547467189374239
cid	Comment ID	7578605549794034443
createTime	Unix timestamp (seconds) for the comment	1732995615
createTimeISO	ISO timestamp for the comment	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 (API flag)	false
pinnedByAuthor	Whether the comment is pinned by the author (API flag)	false
repliesToId	Parent comment ID (null for top-level comments)	null
replyCommentTotal	Total number of replies reported by TikTok	100
uid	Commenter’s user ID	7516601022924489733
uniqueId	Commenter’s username (handle)	amin.hrizi4
avatarThumbnail	URL of the commenter’s avatar thumbnail	https://p16-sign-va.tiktokcdn.com/...
mentions	Array of usernames mentioned in the text	["someuser"]
detailedMentions	Array with mention metadata (positions, IDs)	[{"user_unique_id":"someuser","start":0,"end":9}]
replies	Array of reply objects (same shape as comments, without nested replies)	[]

Notes:

• Replies are returned as flat objects inside the parent comment’s replies array (reply objects do not include a nested replies field).
• Datasets can be exported to JSON or CSV from the Apify Console.

Key features

• ⚡ Smart proxy fallback & resilience: Starts with no proxy and automatically falls back to datacenter, then residential proxies with up to 3 retries — ensuring maximum continuity when scraping at scale.
• 📚 Two input modes (URLs or profiles): Provide postURLs to target specific videos, or use profiles with profileScrapeSections, profileSorting, and date filters to discover videos first and then extract comments.
• 🧵 Concurrent, scalable scraping: Processes multiple videos concurrently (default concurrency in code is 10 videos; replies fetching also concurrent), making it a best TikTok comments scraper for larger lists.
• 🧠 Mentions extraction: Extracts mentions from comment text plus detailed positions via text_extra parsing, providing clean, structured TikTok comments data extraction.
• 🗂 Clean, structured JSON output: Pushes consistent records with text, timestamps (unix + ISO), likes, reply counts, commenter IDs, handles, avatars, mentions, and replies — ready to export tiktok comments to CSV or JSON.
• 👩‍💻 Developer-friendly & API-ready: Built in Python with apify-client on the platform; easy to integrate as a tiktok comments scraper API or call from tiktok comments scraper python scripts.
• 🔍 Profile discovery tools: Use profileSorting (latest, oldest, popular), resultsPerPage limits, and date filters (oldestPostDateUnified, newestPostDate) to control which videos are selected from profiles before comment extraction.
• 🧭 Robust logging: Clear logs on proxy events and scraping steps help you monitor progress and diagnose issues quickly.

How to use Tiktok Comments Scraper - step by step

1. Create or log in to your Apify account.
2. Open the Tiktok Comments Scraper actor in the Apify Console.
3. Choose your input method:
   • To scrape specific videos: add one or more URLs to postURLs.
   • To discover videos from profiles: add one or more usernames to profiles (without @).
4. Configure discovery (profile inputs only, optional):
   • Set resultsPerPage for how many videos per profile to collect.
   • Choose profileScrapeSections (videos and/or reposts).
   • Pick profileSorting (latest, oldest, or popular).
   • Set oldestPostDateUnified and/or newestPostDate to constrain by date.
   • Optionally set excludePinnedPosts to skip pinned items.
5. Configure comment extraction:
   • Set commentsPerPost to limit how many comments to collect per video.
   • Set maxRepliesPerComment if you also want to fetch some replies per comment.
6. Configure proxy settings (optional): proxyConfiguration lets you bring your own proxy setup; the actor still starts with no proxy and falls back automatically if TikTok blocks requests.
7. Run the actor and monitor logs: you’ll see clear “PROXY EVENT” messages and per-video progress.
8. Download your results: Go to the Dataset tab to export as JSON or CSV. The actor also writes a full array to the key-value store as output.json for convenience.

Pro tip: Use the Apify API to trigger runs and stream datasets into your data warehouse or analytics workflows for automated tiktok comments scraper online pipelines.

Use cases

Use case	Description
Social listening & sentiment	Analyze comment themes and reactions on branded or creator videos to inform messaging and community strategy.
UGC mining	Identify high-signal comments and reply threads to source user-generated content ideas and creators.
Competitor research	Track engagement patterns and audience feedback on competitor posts to benchmark performance.
Trend analysis	Extract comments across profiles to surface emerging topics, memes, and product mentions for market intelligence.
Community moderation	Monitor replies and mentions to flag risks, FAQs, or recurring support issues quickly.
Data enrichment via API	Schedule runs and pipe structured outputs into your data stack using the Apify API for continuous tiktok comments data extraction.
Academic & media research	Build reproducible datasets of TikTok comments to study discourse, virality, and platform dynamics.

Why choose Tiktok Comments Scraper?

This scraper prioritizes reliability, structure, and automation to deliver clean comment datasets without fragile browser hacks.

• 🎯 Accurate, structured output: Consistent JSON fields for text, timestamps, likes, mentions, and replies — ready for immediate analysis.
• 🧩 Flexible inputs: Scrape by direct video URLs or discover videos from profiles with sorting and date filters.
• 🔁 Resilient proxy logic: Automatic fallback from no proxy → datacenter → residential with logged attempts and rotations.
• 🚀 Built for scale: Concurrency on videos and replies enables faster collection across larger input lists.
• 👩‍💻 Developer access: API-ready and Python-friendly; ideal for pipelines, dashboards, and notebooks.
• 🔒 Ethical-by-design: Collects data from publicly available TikTok endpoints only.
• 💸 Efficient workflows: Export tiktok comments to CSV/JSON and plug into BI tools — no brittle chrome extensions required.

Bottom line: a reliable tiktok comments scraper tool for production workflows, superior to unstable browser add-ons.

Is it legal / ethical to use Tiktok Comments Scraper?

Yes — when used responsibly. This actor collects data from publicly available TikTok sources and does not access private accounts or password-protected content.

Guidelines to follow:

• Only collect and use publicly available data.
• Respect TikTok’s Terms of Service and applicable rate limits.
• Ensure your use complies with privacy and data protection laws (e.g., GDPR/CCPA).
• Avoid spam or misuse; consult your legal team for edge cases or regulated use.

Input parameters & output format

Example JSON input

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

Parameters

Field	Type	Description	Default	Required
postURLs	array of strings	TikTok video URLs to extract comments from. If provided, takes priority over profiles.	—	No
commentsPerPost	integer	Max number of comments to extract per video. Actual totals may vary due to TikTok limitations.	100	No
maxRepliesPerComment	integer	Max number of replies to fetch per comment. Successful extraction of all desired replies is not guaranteed.	3	No
profiles	array of strings	TikTok usernames to scrape videos from (without @). Used when postURLs are not provided.	—	No
resultsPerPage	integer	Number of videos to scrape per profile.	10	No
profileScrapeSections	array of strings	Profile sections to scrape: "videos", "reposts".	["videos"]	No
profileSorting	string	Sorting for profile videos: "latest", "popular", "oldest". Date filters only work with latest and oldest.	"latest"	No
oldestPostDateUnified	string	Only scrape videos uploaded after/on this date. Supports "YYYY-MM-DD" or relative like "5 days", "2 weeks".	—	No
newestPostDate	string	Only scrape videos uploaded before/on this date. Supports "YYYY-MM-DD" or relative like "5 days", "2 weeks".	—	No
excludePinnedPosts	boolean	Exclude pinned posts from profiles.	false	No
proxyConfiguration	object	Choose proxies. If blocked, the actor falls back to datacenter then residential with 3 retries.	{"useApifyProxy": false} (prefill)	No

Notes:

• When using profiles, the actor discovers video URLs first (with Playwright-backed API interception) and then scrapes comments.
• The run logs “PROXY EVENT” messages to show current proxy mode and fallback attempts.

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": []
  }
]

Fields that may be empty:

• mentions, detailedMentions, avatarThumbnail, and replies can be empty if no data is present or the TikTok response omits those values.

FAQ

Is there a free tier to test the scraper?

Yes. Apify provides trial minutes for new users, which you can use to run the actor before subscribing. The current plan configuration for this actor includes trial minutes in the listing.

Can I extract replies to comments?

Yes. Set maxRepliesPerComment to a positive number. The actor will fetch up to that many replies per comment where available. Note that the schema warns successful extraction of all desired replies is not guaranteed.

Can I scrape multiple TikTok videos at once?

Yes. Add multiple URLs to postURLs to process them in a single run. Alternatively, provide profiles to discover videos first and then scrape their comments.

Can I sort or filter which videos are processed from profiles?

Yes. Use profileSorting ("latest", "popular", or "oldest"), resultsPerPage to limit how many videos per profile, and optional date filters (oldestPostDateUnified, newestPostDate). You can also excludePinnedPosts.

Does this work as a tiktok comments scraper API or with Python?

Yes. The actor runs on Apify and is API-ready. You can trigger runs and fetch datasets via the Apify API, and integrate it with tiktok comments scraper python scripts using apify-client.

Is this a Chrome extension?

No. This is an Apify actor (server-side). It is more reliable than a tiktok comments scraper chrome extension for large-scale runs and structured exports.

What happens if TikTok blocks requests during a run?

The actor uses a smart proxy fallback: it starts with no proxy, falls back to datacenter proxy if blocked, then to residential proxy with up to 3 retries. Once residential is active, it remains sticky for the rest of the run.

In what formats can I download results?

You can export your tiktok comments dataset to JSON or CSV from the Apify Console. The actor also writes a consolidated output.json file to the key-value store.

Closing thoughts

Tiktok Comments Scraper is built for fast, structured extraction of TikTok video comments at scale. With flexible inputs (URLs or profiles), smart proxy fallback, and clean JSON records (including mentions and replies), it’s ideal for marketers, developers, analysts, and researchers. Use it as your tiktok comments scraper tool to export tiktok comments to csv, automate pipelines via the Apify API, and power social listening or trend analysis with confidence. Start extracting smarter, richer TikTok comment datasets today.