This tutorial shows how to scrape TikTok comments from one video into a reviewable CSV with the TikTok Video Details Comments Scraper template for UScraper. You will replace the sample video URL, run a watched browser workflow, export comment rows with video details, and validate the fallback status when TikTok does not render comments.
Before you start
Prerequisites for a TikTok comments scraper
Start with one approved TikTok video URL, not a list. Open the video in a normal browser session first and confirm the video itself loads, comments are visible, and your intended use is allowed by your internal policy, TikTok terms, privacy rules, and local law.
You also need UScraper installed as a local desktop app and the maintained JSON from the template page. The template is built for visible page data. It is not a hidden API client, comment spam tool, CAPTCHA solver, private account viewer, or workaround for unavailable content.
Treat TikTok comment scraping as an evidence collection workflow. Keep the source URL, collection date, run notes, and reason for collection beside the CSV so another reviewer can understand what was captured and what was not.
API context
TikTok API comments vs a browser export
Searches for tiktok api comments alternative and tiktok research api comments usually come from the same question: should you use an official endpoint, an unofficial script, a hosted scraper API, or a local CSV workflow?
For eligible non-profit research, TikTok documents Research Tools and separate endpoints to query videos and query video comments. TikTok also documents a Display API video query for developer integrations around authorized video metadata. Those routes are the right first stop when your project matches the access model, review process, scopes, and allowed data use.
A UScraper workflow is different. It opens the public video page in a browser session and exports what TikTok renders to that session. That makes it useful for analyst-led CSV work, but it also means results are best-effort: comments can be hidden by login state, region, rate limits, deleted content, disabled comments, page changes, or anti-abuse checks.
| Approach | Best fit | Trade-off |
|---|---|---|
| TikTok Research API | Approved research projects that qualify for official data access | Eligibility, permitted use, and endpoint rules come first. |
| TikTok Display API | App integrations around authorized video metadata | Not a general arbitrary-video comment export workflow. |
| Python or Playwright scraper | Engineering teams that want code ownership | You maintain selectors, sessions, retries, storage, and compliance review. |
| Hosted scraper API | Programmatic cloud jobs and normalized API responses | Usually adds metered pricing, vendor schemas, and cloud custody. |
| UScraper template | Supervised local CSV export from one visible video | Best-effort browser rendering; validate before scaling. |
Workflow
How the TikTok video comments scraper workflow runs
The JSON export is the source of truth for the workflow. In plain English, the graph is:
Set Window Size -> Navigate -> Wait for Page Load -> close consent prompts
-> Sleep -> Wait for page body -> detect comments -> Wait for tagged rows
-> Structured Export -> End
Replace the sample TikTok URL in the Navigate block with one approved video URL. Keep one video per validation run so you can compare the browser and CSV quickly.
Steps
Scrape TikTok comments to CSV
Import the template
Open the related template page, download the hosted JSON, import it into UScraper, and inspect the workflow canvas before editing anything.
Replace the video URL
Paste one TikTok video URL into the Navigate block. Prefer a public video where you can already see comments in the browser session.
Keep the first-run pacing
Leave the page-load wait, short sleep, consent handling, and comment-row detection blocks unchanged for the first watched run.
Confirm the export folder
Set Structured Export to the folder you want and keep headers enabled. The default file name is tiktok-video-comments-scraper.csv.
Run and inspect
Open the CSV, compare several comment rows against the browser, and record whether the run exported real comments or the fallback status row.
Export shape
TikTok video details and comments in the CSV
The export repeats video-level context on each comment row, which makes the CSV easier to filter, join, and audit later. When TikTok does not expose visible comments, the template creates one fallback metadata row and sets comment_text to NO_VISIBLE_COMMENTS_LOADED_TIKTOK_BLOCK_OR_LOGIN_REQUIRED.
tiktok-video-comments-scraper.csvColumn
url
Video URL processed in the run.
Column
tiktoker_nikname
Creator display name from page metadata.
Column
post_date
Post timestamp when TikTok exposes it.
Column
content
Caption or description text.
Column
hashtag
Visible hashtag links joined into one field.
Column
like_num
Video like count.
Column
comment_num
Visible video comment count.
Column
views_num
Visible video view count when available.
Column
video_id
Video ID parsed from the URL.
Column
music_name
Music title from the linked music page.
Column
comment_person
Visible commenter name or profile text.
Column
comment_text
Comment body or fallback status message.
Column
comment_likes
Like count on the comment row.
Column
reply_num
Reply count found in the comment row.
Column
comment_date
Visible comment date or timestamp.
| Field group | Columns to spot-check | Why it matters |
|---|---|---|
| Source | url, video_id, poster | Confirms the row belongs to the intended video. |
| Video context | content, hashtag, like_num, views_num | Keeps comments tied to the caption and engagement snapshot. |
| Comment record | comment_person, comment_text, comment_likes, reply_num, comment_date | Gives analysts the actual row-level material to classify. |
| Diagnostics | fallback comment_text value | Separates "no comments loaded" from an accidental blank file. |
Validation
Troubleshoot empty or partial TikTok comment exports
Empty comment exports are not always workflow failures. TikTok comments are lazy-loaded and can be hidden behind login, age, region, moderation, network, or anti-abuse states. The first check is visual: if you cannot see the comments in the browser window, the CSV should not be expected to contain them.
Use this validation pass before relying on the export:
- Confirm the CSV was recreated in the expected folder.
- Check whether
comment_textcontains the fallback status. - Compare
url,video_id, and caption text against the browser. - Spot-check three visible comments for commenter, text, likes, replies, and date.
- Save a run note with video URL, collection date, login state, region, and any TikTok prompt shown on screen.
FAQ
Frequently asked questions
Yes, for small supervised exports you can use a browser-based workflow that records comments rendered on a public TikTok video page. That is not the same as official API access, and it should only be used for approved, compliant collection.
Next step
Download the TikTok comments scraper template
Use this tutorial as the runbook, then download the current JSON from the TikTok Video Details Comments Scraper template. For broader workflows, browse the UScraper template library or read more tutorials in the UScraper blog.