Skip to content
Eden Engine

Douyin Comment Replies Lookup (by Video ID and Comment ID)

omnial/douyin-app-fetch-video-comment-replies

Given a Douyin video id and a comment id on that video, returns the replies posted under that comment: each reply's text, like count, timestamp, author (display name, handle, public user id), which reply or user it was addressed to, and pagination cursor/total for walking the full thread. A comment id that does not belong to the given video still returns real reply data rather than an error -- the endpoint does not cross-validate the pairing.

activeper callv2

Price

Up to $0.00205 per call; you pay what the call used

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.

Data source

Douyin

Data from Douyin.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/douyin-app-fetch-video-comment-replies" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/douyin-app-fetch-video-comment-replies" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/douyin-app-fetch-video-comment-replies", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/douyin-app-fetch-video-comment-replies", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.00205
Updated
Oct 27, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "item_id",
    "comment_id"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "description": "Number"
    },
    "cursor": {
      "type": "integer",
      "default": 0,
      "description": "Cursor"
    },
    "item_id": {
      "type": "string",
      "examples": [
        "7354666303006723354"
      ],
      "description": "Video id"
    },
    "comment_id": {
      "type": "string",
      "examples": [
        "7354669356632638218"
      ],
      "description": "Comment id"
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "comments",
    "cursor",
    "has_more",
    "total"
  ],
  "properties": {
    "total": {
      "type": "number",
      "description": "Total reply count under the queried comment. Can be 0 even when replies are returned (e.g. 0 alongside 8 replies) -- do not treat this as an accurate count."
    },
    "cursor": {
      "type": "number",
      "description": "Pass back as `cursor` to fetch the next page."
    },
    "comments": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The reply's own comment id (source: cid)."
          },
          "text": {
            "type": "string"
          },
          "user": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Source: uid."
              },
              "handle": {
                "type": "string",
                "description": "The author's public Douyin handle. Empty string when unset (source: unique_id)."
              },
              "region": {
                "type": "string",
                "description": "Country code, e.g. 'CN'."
              },
              "sec_uid": {
                "type": "string",
                "description": "Douyin's opaque secure user id."
              },
              "nickname": {
                "type": "string",
                "description": "The author's public display name."
              },
              "short_id": {
                "type": "string"
              }
            },
            "description": "The reply's author.",
            "additionalProperties": false
          },
          "is_hot": {
            "type": "boolean"
          },
          "video_id": {
            "type": "string",
            "description": "The video this reply belongs to (source: aweme_id)."
          },
          "can_share": {
            "type": "boolean",
            "description": "Not present on every reply observed."
          },
          "is_hidden": {
            "type": "boolean",
            "description": "Whether the reply is buried/collapsed by moderation (source: user_buried)."
          },
          "badge_text": {
            "type": "string",
            "description": "A badge label Douyin shows next to the reply, e.g. '作者' (author). Empty string when none."
          },
          "badge_type": {
            "type": "number"
          },
          "created_at": {
            "type": "number",
            "description": "Unix seconds."
          },
          "like_count": {
            "type": "number",
            "description": "Source: digg_count."
          },
          "can_collect": {
            "type": "boolean"
          },
          "reply_count": {
            "type": "number",
            "description": "Total replies to this specific reply, when the endpoint reports it (source: comment_reply_total). Not always present."
          },
          "author_liked": {
            "type": "boolean",
            "description": "Whether the video's own author liked this reply (source: is_author_digged)."
          },
          "nesting_level": {
            "type": "number",
            "description": "Source: level."
          },
          "root_comment_id": {
            "type": "string",
            "description": "The thread's top-level comment id. Present on some responses and absent on others -- the endpoint does not always return it, not required."
          },
          "reply_to_user_id": {
            "type": "string",
            "description": "Public user id of the user this reply is addressed to (source: reply_to_userid)."
          },
          "parent_comment_id": {
            "type": "string",
            "description": "The comment id this reply was posted under (source: reply_id)."
          },
          "reply_to_nickname": {
            "type": "string",
            "description": "Display name of the user this reply is addressed to. Present only on replies nested under another reply, not on a reply addressed directly to the root comment (source: reply_to_username)."
          },
          "reply_to_comment_id": {
            "type": "string",
            "description": "The specific reply this one is addressed to within the thread, when nested more than one level deep (source: reply_to_reply_id). '0' on a reply addressed directly to the root comment."
          },
          "reply_to_user_sec_id": {
            "type": "string",
            "description": "Douyin's opaque secure user id for the user this reply is addressed to."
          }
        },
        "additionalProperties": false
      },
      "description": "The replies to the given comment. Typically non-empty."
    },
    "has_more": {
      "type": "number",
      "description": "Observed as 0 or 1 (not a boolean) on real calls -- truthy/falsy integer."
    }
  },
  "description": "The reply-list record.",
  "additionalProperties": false
}