TikTok API 文档

TikTok API: 视频 — 按媒体 ID 获取评论

从 TikTok 获取公开的视频对话,用于受众监控、审核和内容分析。

当您需要讨论文本、作者、时间戳和顺序分页时,请使用“按媒体 ID 获取评论”。

方法 GET
实体 视频
版本 2
此端点的作用

利用此 API 方法可以构建什么

先查看结果和常见工作流,然后再了解参数和可运行的请求示例。

此端点可以帮助您

响应包含对话条目、公开的作者数据、互动信号和分页字段。

何时使用

当您需要讨论文本、作者、时间戳和顺序分页时,请使用“按媒体 ID 获取评论”。

常见使用场景

对话监控

跟踪受众在内容下方以及围绕所选对象的反应。

内容审核

将公开消息送入审核、分类和质量控制队列。

反馈分析

在报告和受众研究中使用讨论文本和元数据。

可用版本

响应版本

两个版本完成相同的任务,接受相同的参数。使用切换按钮比较响应结构,并选择您的客户端所需的版本。

响应版本 V2

在本页面切换版本,即可在同一文档 URL 下比较响应结构。

保持不变的部分

V1 和 V2 的身份验证、必填参数和请求结构均相同。实际上,您只需在构建端点路径和解析响应时选择版本。

版本之间的差异

主要区别在于响应结构。新集成请使用 V2;仅在需要兼容现有客户端契约时保留 V1。

使用方法

如何调用该方法

两个版本使用相同的 API 密钥请求头和相同的查询参数。本文档先展示共享的参数集合,然后展示各版本特定的端点路径和代码片段。

输入参数

共享参数
参数 必填 类型 示例 说明
media_id 是 str 7358140719266102561 要获取其数据的 Instagram 帖子的数字 ID。
cursor 否 str | None 20 上一次响应返回的下一页游标。获取第一页时请省略。

各版本的请求路径

V2

复制确切的端点路径、示例 URL 和代码片段时请选择版本。上方的参数列表保持不变。

GET /api/v2/tiktok.com/videos/comments-by-media-id

规范化格式

代码示例

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/tiktok.com/videos/comments-by-media-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'media_id=7358140719266102561' \
  # Optional parameters:
  # --data-urlencode 'cursor=20'
响应示例

按版本查看真实响应

预览保留了关键字段和集合中的前几项,便于您快速浏览响应结构。切换版本会改变 JSON 格式。

响应示例

V2 响应 JSON

已验证示例

此简明 JSON 示例来自 V2 最近一次成功的验证运行。

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "20",
    "has_more": true
  },
  "search_context": {
    "media_id": "7628619815690833183"
  },
  "data": {
    "comments": {
      "count": 20,
      "items": [
        {
          "url": null,
          "created_at": "2026-04-16T12:29:47Z",
          "comment_id": "7629333241903973142",
          "text": "Why is the \"ALLOW AI TO remix content automatically\" setting on for all videos in privacy settings?",
          "author": {
            "url": "https://www.tiktok.com/@Stylesanctuary",
            "user_id": null,
            "sec_uid": null,
            "username": "Stylesanctuary",
            "display_name": "Stylesanctuary",
            "avatar_url": "https://example.com/image.jpg",
            "avatar_urls": "https://example.com/image.jpg"
          },
          "like_count": 109,
          "reply_count": null,
          "reply_id": "0",
          "parent_comment_id": "0",
          "is_author_liked": false,
          "is_pinned": null
        },
        {
          "url": null,
          "created_at": "2026-04-17T13:21:54Z",
          "comment_id": "7629717687844832013",
          "text": "Give us a master switch off for AI remix. You can’t make us go back through everything on our page for a feature that was just added.",
          "author": {
            "url": "https://www.tiktok.com/@MalikaNgozi🇸🇩🇵🇸🇨🇩",
            "user_id": null,
            "sec_uid": null,
            "username": "MalikaNgozi🇸🇩🇵🇸🇨🇩",
            "display_name": "MalikaNgozi🇸🇩🇵🇸🇨🇩",
            "avatar_url": "https://example.com/image.jpg",
            "avatar_urls": "https://example.com/image.jpg"
          },
          "like_count": 263,
          "reply_count": 5,
          "reply_id": "0",
          "parent_comment_id": "0",
          "is_author_liked": false,
          "is_pinned": null
        },
        {
          "_more_items": 18
        }
      ]
    }
  }
}
下一步

继续评估

将本文档作为第一个决策点,然后在将端点接入常规使用之前,继续了解价格、平台覆盖范围和集成规则。

打开 TikTok 平台页面

在实现之前,比较相邻的实体、API 方法分组和相关文档。

打开平台页面

比较 API 方法价格

在扩大使用规模之前,查看此 API 方法在公开价格表中的位置。

查看价格

查看集成规则

通过入门文档确认身份验证、版本管理、重试以及模拟环境与正式环境的差异。

打开文档
常见问题

团队在实现前常问的问题

借助这些解答,判断此 API 方法是否适合您的工作流、版本选择和上线计划。

此 TikTok API 方法返回哪些数据?

该方法针对视频执行“按媒体 ID 获取评论”操作。下方的简明响应示例展示了确切的字段结构。

应该选择 V1 还是 V2?

新集成请选择 V2,因为它提供规范化的结构。仅在兼容已使用平台原生格式的客户端时使用 V1。

第一个请求需要准备什么?

创建 API 密钥,在请求头中发送它,并提供表格中的必填参数。代码示例中已包含正确的路径和请求结构。