douyin/
video-comments

The Douyin Video Comments API collects one page of public comments from a direct Douyin video URL, returning normalized text, author, relationship, time, and visible engagement fields.

Douyin Video Comments API

Direct video URL
One source page
CommentItem 1.0
0.1 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Douyin Video Comments

Douyin video comments are public responses attached to a video, with text, author identity, publication context, and visible like or reply signals. These records support audience-response review, conversation mapping, and point-in-time engagement comparison.

Douyin Video Comments API Features

  • Direct video targetingResolve the numeric video ID from one public douyin.com or iesdouyin.com URL whose path contains /video/{numeric_id}.
  • Bounded one-page collectionEach Douyin Video Comments API task requests up to 20 comment rows from the first source page, with results_limit controlling the stored subset from 1 through 20.
  • Canonical comment contextReturn CommentItem 1.0 records with text, author identity, video and parent relationships, publication and collection times, and visible like or reply counts.

Douyin Video Comments API Parameters

ParametersRequiredDescription
urlRequiredRequired public URL on douyin.com, iesdouyin.com, or a subdomain. Its path must contain /video/ followed by a numeric video ID.
results_limitOptionalOptional integer from 1 through 20. Omission defaults to 20; the integration requests only the first source page.

How to Use the Douyin Video Comments API

Set a direct public Douyin video URL, submit the asynchronous Douyin Video Comments API task, and read the normalized comments stored for that task.

  1. Set DOUYIN_VIDEO_URL to a public douyin.com or iesdouyin.com URL with a /video/{numeric_id} path.
  2. POST url and the optional results_limit to /v1/douyin/video-comments, then save task_id.
  3. Poll /v1/tasks/{task_id} until the task succeeds or fails.
  4. Read data.results.items and follow next_cursor only while has_more is true to continue through records already stored by SocQ.
curl -X POST "https://api.socq.ai/v1/douyin/video-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"${DOUYIN_VIDEO_URL}\",\"results_limit\":20}"

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Douyin Video Comments API Use Cases

  • Audience-response review: Use the comment text, author identity, and visible like or reply counts from the Douyin Video Comments API to review responses to a known public video.
  • Comment relationship mapping: Connect returned comments to the source video and any supplied parent reference with post_id and parent_id.
  • Engagement snapshot comparison: Compare visible comment signals across selected videos or collection times while retaining collected_at as the observation timestamp.

Douyin Video Comments API Pro Tips

  • Resolve a shared or redirected link to its final accepted /video/{numeric_id} URL before submitting it, so host and path validation can succeed.
  • Omit results_limit to request 20 rows, or choose a smaller integer when only a subset of the one returned source page is needed.
  • Reuse the original task_id and follow next_cursor only when has_more is true; that cursor reads stored rows and does not fetch another source page.
  • Use the comment id as the primary deduplication key, and allow parent_id or post_id to remain null when the source row omits a relationship.
  • Treat author details, published_at, and individual metrics as optional, and use collected_at to timestamp every result snapshot.
  • Escape comment text before inserting it into HTML because public comments are user-generated content.

Beyond the Douyin Video Comments API, use these APIs when you need a different type of public Douyin data.

Explore other platforms

Combine Douyin data with public data from other supported social platforms.

Douyin Video Comments API — FAQ

Douyin Video Comments API collects one page of public comments from a Douyin video URL with a numeric video path, returning normalized text, author, relationship, time, and visible like or reply-count fields.

The url must use douyin.com, iesdouyin.com, or a subdomain, and its path must contain /video/ followed by a numeric ID. Profile, search, and non-video paths are rejected.

results_limit accepts integers from 1 through 20 and defaults to 20. The task requests one source page, so it cannot continue into additional source pages.

CommentItem 1.0 includes base identity and time fields plus text, author, parent_id, post_id, and metrics containing likes_count and replies_count. Optional source fields remain null when unavailable.

It does not make a separate reply-page request. A returned row can expose replies_count and a parent_id when supplied by the source, but those fields do not imply that reply text was collected.

next_cursor belongs to GET /v1/tasks/{task_id} and paginates records SocQ already stored after success. It never requests the next Douyin source page.

Each successful task costs a fixed 0.10 SocQ credits, independent of results_limit or returned item count; failed tasks follow the runtime refund path.