Submit a TikTok username and retrieve its collected video records after the collection task finishes
TikTok Video Comments
Give one TikTok content ID and an expected comment count to receive public comments, authors, engagement, and publish times
Overview
Public comments on a TikTok video show how viewers react in their own words, which remarks attract replies, and whether the creator likes or pins a comment. This Data App turns the public comment area of one video into a consistent dataset with comment text, author details, reply relationships, engagement snapshots, and timestamps.
The result is suited to repeatable analysis rather than manual scrolling. It keeps the original comment wording and connects each comment to its video, author, parent comment, and root comment, making it easier to compare reactions, identify recurring themes, and inspect conversations around a video.
Data notes
The data covers comments that are publicly visible on the supplied TikTok video at collection time. Each normal record is identified by its Comment ID, which is used to remove duplicates. Private, deleted, and closed-comment videos are outside the coverage.
Like count, Reply count, Liked by author, and Pinned by author are snapshots and may change after collection. Count values, classification values such as Comment type, and mention fields are retained as source text rather than converted into numbers or lists. Published at and Collected at preserve the source timestamps without inferring a timezone. Keyword, Business ID, Content ID, and Source item may repeat the submitted content ID when that is what the source record carries. Image URLs is empty when the comment has no image. Parent comment ID is usually 0 for a top-level comment. No data retains the collection outcome when a video has no public comment result.
What the results look like
Each normal record represents one publicly visible comment from the selected TikTok video.
| Comment ID | Comment text | Author name | Published at | Like count | Reply count |
|---|---|---|---|---|---|
| 7676928910512587528 | 🔥🔥🔥 | LOR3NZO 🥵 | 2026-08-23T02:45:14 | 1 | 0 |
| 7676937550266663696 | Hi | F00tba11EDITS | 2026-08-23T03:18:57 | 0 | 0 |
Additional values include avatar and author identifiers, reply relationships, creator interaction flags, collection timestamps, mention text, and the no-data outcome.
Use cases
- Compare Comment text with Like count and Reply count to identify remarks that generated stronger visible engagement.
- Group Comment text by recurring phrases, then use Published at to see how the discussion changed over time.
- Reconstruct reply threads with Parent comment ID, Root comment ID, and Comment type to distinguish top-level remarks from follow-up replies.
- Review Liked by author and Pinned by author together with Author ID to see how the creator participated in the discussion.
Scope and boundaries
Each run collects comments from one TikTok video. The expected comment count is 1 to 10000. Results are returned in complete batches of 20, so the actual count may be rounded up. Only publicly visible comments at collection time are covered.
- Good for
- When you need public comment text and engagement details from a specific TikTok video
- When you need comment authors, reply relationships, timestamps, and creator interaction signals for analysis
- Do not use for
- When you need comments from more than one video in a single run — submit a separate run for each video
- When you need private, deleted, or closed-comment data — this App covers publicly visible comments only
Failure handling
Failure and retry behavior declared by the developer. We recommend including it in your system prompt when integrating.
- 1If no comments are returned, verify the content ID and confirm that the video and its comments are publicly visible
- 2Retry later after rate limiting, temporary service unavailability, or a timeout
- 3When the submission outcome is unknown, avoid immediate repeated submissions that could create duplicate tasks
- 4If authentication fails, verify the API Key configured for the execution environment
Input
Parameters required to call this App, generated from the input.schema in manifest.json.
- Content ID
content_idRequiredstringThe numeric ID of the public TikTok video whose comments will be collected. Enter one content ID only, not a keyword or URL.Example7676927940759653650 - Expected comment count
comment_countRequiredintegerThe expected number of comments to collect, from 1 to 10000. Results are returned and billed in complete batches of 20, so the actual count may be rounded up.Range1–10000Example20
Output
Field structure of a single record, generated from the output.schema in manifest.json.
- Comment ID
comment_idstringThe stable unique identifier of the TikTok commentExample7676928910512587528 - Content ID
content_idstringThe identifier of the TikTok video associated with the commentExample7676927940759653650 - Record ID
cur_idstringThe source record identifier returned with this commentExample6a8fe471f5f83d2da3b7649d - Comment type
comment_typestringThe source value identifying the comment type, retained as source textExample1
Sample data
Generated from output.schema. Fields without a sample value use structural placeholders.
{
"comment_id": "7676928910512587528",
"content_id": "7676927940759653650",
"cur_id": "6a8fe471f5f83d2da3b7649d",
"comment_type": "1",
"root_comment_id": "7676928910512587528",
"parent_comment_id": "0",
"comment_user_id": "7577435595783603221",
"comment_user_avatar_url": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/02b166b17f1f9cd4fd5bcab5b12d3b4f~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=e18e22e5&x-expires=1787900400&x-signature=NEB%2BONXLIJ33UyKgKI6NOuyNNS0%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=useast5",
"comment_user_name": "LOR3NZO 🥵",
"comment_text": "🔥🔥🔥",
"publish_time": "2026-08-23T02:45:14",
"image_urls": "<image_urls>",
"crawl_time": "2026-08-27T15:17:02",
"like_count": "1",
"keyword": "7676927940759653650",
"sec_id": "MS4wLjABAAAAPbxslh-t5xoPlxOuQY3X4ZNjqiwy2dBXmUa5HM7crjnOmIAJTTzKPm5aYI79jHTn",
"biz_id": "7676927940759653650",
"detailed_mentions": "[]",
"liked_by_author": true,
"mentions": "[]",
"pinned_by_author": false,
"reply_comment_total": "0",
"source_item": "7676927940759653650",
"no_data": false
}Integration
This App can be integrated via MCP, API, SDK, or file export. All channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API key (long-lived, created in the Data Hub Console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way. This App runs asynchronously and can be canceled midway: After you cancel, the run stops. Records already delivered are kept and billed.
With the MCP (Model Context Protocol), you can call this App directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.
Client config
Replace the value after Bearer with your long-lived API key. Works in any client, CI, or headless environment.
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/tiktok-video-comments",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Let AI set it up for you
Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client. It will complete the setup its own way. (By default it guides you through signing in, and never asks you to send your API key in the chat.)
detail.access.mcp.composeHint
Pricing
Charged by the number of records successfully returned. Failed runs are not charged. Billed in units of 20 records; any partial unit is rounded up to 20 records.
Charged once per submitted run, regardless of how many records are returned.
Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.
View creditsTry it now
Fill in the parameters and run. Results come from a real call.