EN

Douyin Video Comments

Collect public comments, engagement details, author information, and timestamps from one Douyin video

Developer
Pricing
From $0.003 / 20 records
Last updated
2026-09-22

Overview

Public comments on a Douyin video show how viewers react in their own words, which topics trigger replies, and how visible engagement develops around the content. 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 and discussion thread, making it easier to compare reactions, identify recurring themes, and inspect conversations around a post.

Data notes

The data covers comments and author details that are publicly visible for the supplied Douyin video at collection time. Each normal record is identified by its Comment ID, which is used to remove duplicates across collected pages. Private, deleted, restricted, and login-only comments are outside the coverage.

Like count, Favorite count, Repost count, Reply count, View count, author details, and Comment status are snapshots and may change after collection. Count values and several classification values are retained as source text rather than converted into numbers. Comment images are also retained in the source text form supplied with each record. Published at and Collected at preserve the source timestamps without inferring a timezone. Source video ID and No data retain 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 Douyin video.

Comment IDComment textAccount namePublished atLike countReply count
7675002466995684133【探险者】坐进探险者,开启感官之旅[赞][赞]颜西枣A2026-08-17T22:09:2500
7675504408697275187此用户没有填写评价艾杰很哇塞!2026-08-19T06:37:1500

Additional values include account and avatar details, location text, comment and content links, reply-thread identifiers, image information, verification data, recognized speech and on-screen text, and collection time.

Use cases

  • Compare Comment text with Like count and Reply count to identify reactions 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 and Root comment ID to distinguish top-level reactions from follow-up conversations.
  • Review Account name, Verification type, IP location, and Location cities to describe the visible mix of participants without treating those fields as verified identity data.

Scope and boundaries

Each run accepts one Douyin video ID and an expected count from 1 to 200. Results are returned in complete batches of 20, so the actual count may be rounded up. Only publicly available comments are covered.

  • Good for
  • When you need public comment text and engagement details from a specific Douyin video
  • When you need comment authors, reply relationships, timestamps, and location text for analysis
  • Do not use for
  • When you need comments from a platform other than Douyin
  • When you need private, deleted, restricted, or login-only comments

Failure handling

Failure and retry behavior declared by the developer. We recommend including it in your system prompt when integrating.

  1. 1If no comments are returned, verify the video ID and confirm that the video and its comments are publicly visible
  2. 2Retry later after rate limiting, temporary service unavailability, or a timeout
  3. 3When the submission outcome is unknown, avoid immediate repeated submissions that could create duplicate tasks
  4. 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.

  • Douyin video IDvideo_idRequiredstring
    The numeric ID of the Douyin video whose public comments will be collected. Enter the video ID only, not a keyword or URL.
    Example7675002361652376997
  • Expected comment countcomment_countRequiredinteger
    The expected number of comments to collect, from 1 to 200. Results are returned and billed in complete batches of 20, so the actual count may be rounded up.
    Range1–200Example20

Output

Field structure of a single record, generated from the output.schema in manifest.json.

  • Account IDaccount_idstring
    The Douyin account identifier associated with the comment author
    Example3751974819070941
  • Account nameaccount_namestring
    The public display name of the comment author
    Example颜西枣A
  • Account short IDaccount_short_idstring
    The author's short Douyin identifier when available
    Example37519748
  • Location citiesaccurate_location_citiesstring
    City-level location text associated with the comment author when available
    Example北京

Sample data

Generated from output.schema. Fields without a sample value use structural placeholders.

output.example
{
  "account_id": "3751974819070941",
  "account_name": "颜西枣A",
  "account_short_id": "37519748",
  "accurate_location_cities": "北京",
  "accurate_location_provinces": "北京",
  "asr_text": "坐进探险者,开启感官之旅",
  "avatar_url": "https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c000-ce_oUnA4rIiXJAIIAW2AT2QfevAAkDoAw8H8fRMQe",
  "biz_id": "7675002361652376997",
  "collect_count": "0",
  "comment_id": "7675002466995684133",
  "comment_image_url_list": "[]",
  "comment_text": "【探险者】坐进探险者,开启感官之旅[赞][赞]",
  "comment_type": "1",
  "comment_url": "http://www.douyin.com/video/7675002361652376997",
  "content_id": "7675002361652376997",
  "crawl_time": "2026-08-25T14:02:54",
  "fans": "1200",
  "ip_location": "北京",
  "like_count": "0",
  "ocr_text": "探险者",
  "parent_comment_id": "7675002466995684133",
  "publish_time": "2026-08-17T22:09:25",
  "repost_count": "0",
  "root_comment_id": "7675002466995684133",
  "status": "active",
  "sub_comment_count": "0",
  "source_video_id": "7675002361652376997",
  "no_data": false,
  "verify_type": "0",
  "view_count": "0"
}

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 config
{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=meme_today/douyin-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

Task start

Charged once per submitted run, regardless of how many records are returned.

$0.0001/ run
20 returned comments

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.

$0.003/ 20 records

Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.

View credits

Try it now

Fill in the parameters and run. Results come from a real call.

Example
Parameters are validated against input.schema before submission
From $0.003 / 20 records