FeedMCP

Data APIs / Douyin

Douyin video comments API

Comments under a video: text, time, commenter, likes and reply count, page by page.

Item Value
Endpoint GET https://api.feedmcp.com/v1/douyin/videos/comments/list
ID douyin.videos.comments.list
Price $0.002 / call
Returns A page of Comment objects
Auth Authorization: Bearer $FEEDMCP_API_KEY

Parameters

Name Type Required Description
id string yes Video ID
limit integer no Items per page, default 20, at most 50
cursor string no Pagination cursor. Leave it out for the first page; pass page.next_cursor for the next. Each page is billed on its own

Every endpoint also takes view=full to include the platform's raw data as raw, at the same price.

Returned fields

data.items is a list of Comment objects, with the same fields on every platform:

Field Type Description
id string Comment ID
platform string Platform
text string | null Comment text
created_at string | null Posted at, ISO 8601, UTC
author.id string | null Commenter ID (none for WeChat comments)
author.name string | null Commenter name
likes number | null Likes (score on Reddit, reactions on Facebook)
reply_count number | null Replies
replies_token string | null Token for this comment’s replies (YouTube only; pass it to the replies endpoint)
rating number | null Stars, 1–5 (TikTok Shop reviews only)
variant string | null Variant bought (TikTok Shop reviews only)
images string[] Buyer photos (TikTok Shop reviews only)
verified_purchase boolean | null Verified purchase (TikTok Shop reviews only)

When you are charged

$0.002 per call that returns data. Not found, no data, bad parameters, platform errors and timeouts are free.

Each answer carries meta.billing: what this call cost and the balance left.

Request

cURL

curl "https://api.feedmcp.com/v1/douyin/videos/comments/list?id=7372484719365098803" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/douyin/videos/comments/list",
    params={"id": "7372484719365098803"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

const res = await fetch("https://api.feedmcp.com/v1/douyin/videos/comments/list?id=7372484719365098803", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

From an AI with FeedMCP installed, the call tool:

{
  "endpoint": "douyin.videos.comments.list",
  "params": {
    "id": "7372484719365098803"
  },
  "max_price": "0.002"
}

Response

The data below is made up; the shape is the real one.

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "items": [
      {
        "id": "740000000000000001",
        "platform": "douyin",
        "text": "求装备链接 1",
        "created_at": "2025-11-18T21:05:40.000Z",
        "author": {
          "id": "MS4wLjABAAAAc1",
          "name": "网友1"
        },
        "likes": 29,
        "reply_count": 1
      },
      {
        "id": "740000000000000002",
        "platform": "douyin",
        "text": "求装备链接 2",
        "created_at": "2025-11-18T21:04:40.000Z",
        "author": {
          "id": "MS4wLjABAAAAc2",
          "name": "网友2"
        },
        "likes": 28,
        "reply_count": 2
      }
    ]
  },
  "page": {
    "next_cursor": "eyJjdXJzb3IiOjIwfQ",
    "has_more": true
  },
  "warnings": [],
  "meta": {
    "endpoint": "douyin.videos.comments.list",
    "platform": "douyin",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.002",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

Errors are described in Errors: each says whether you were charged (charged) and whether to retry (retry).

Other Douyin endpoints

Questions

How much does the Douyin video comments endpoint cost?

$0.002 per call that returns data. Not found, no data, bad parameters, platform errors and timeouts are free.

Do I need a platform account?

No. Only public data is read.

A video ID is the number after /video/; an account is the sec_user_id after /user/, not the Douyin handle.

How do I get more items?

When the answer has page.next_cursor, pass it back as cursor for the next page, up to 50 a page. Each page is billed on its own.

How do I use it from an AI?

Install the MCP server and ask; your AI calls douyin.videos.comments.list.