📱 抖音评论 API

HTTP RESTful 接口 · 共享同一数据库 · 实时抓取 & 查询

Base URL

https://api.sjz.life

通用参数

参数	类型	必填	说明
token	string	是	接口调用凭证，需在后台「API 用户管理」中申请

GET/fetch

实时抓取抖音视频评论（从抖音接口拉取并存入数据库）

请求参数

参数	类型	必填	说明
aweme_id	string	是	抖音视频ID
limit	int	否	单次爬取条数，最大 50，默认 20
max_pages	int	否	最大分页数，默认自动（直到爬完或 Cookie 失效）

返回参数说明

字段	类型	说明
code	int	状态码（0=成功）
msg	string	状态说明
data.aweme_id	string	视频ID
data.new_count	int	本次新增入库评论数
data.total_fetched	int	本次从抖音拉取总数（含重复）
data.total_in_db	int	该视频累计入库评论数
data.pages	int	分页次数
data.has_more	int	是否还有更多数据（0=已拉完）
data.comments[].cid	string	评论ID
data.comments[].text	string	评论文字
data.comments[].create_time	int	评论时间戳
data.comments[].create_time_text	string	评论时间（格式化）
data.comments[].reply_comment_total	int	回复数
data.comments[].user.nickname	string	用户昵称
data.comments[].user.uid	string	用户抖音UID
data.comments[].user.avatar	string	用户头像URL

请求示例

# 抓取视频评论，最多 3 条
curl "https://api.sjz.life/fetch?token=YOUR_TOKEN&aweme_id=7645880385793141669&limit=3&max_pages=1"

返回示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "aweme_id": "7645880385793141669",
    "new_count": 5,
    "total_fetched": 50,
    "total_in_db": 156,
    "pages": 1,
    "has_more": 1,
    "comments": [
      {
        "cid": "7460123456789012345",
        "text": "健康科普很有用",
        "create_time": 1780205400,
        "create_time_text": "2026-06-01 14:30:00",
        "reply_comment_total": 3,
        "user": {
          "uid": "123456789",
          "nickname": "阳光健康",
          "avatar": "https://p3.douyin.com/..."
        }
      }
    ]
  }
}

GET/list

查询已入库的评论数据（分页）

请求参数

参数	类型	必填	说明
aweme_id	string	是	抖音视频ID
page	int	否	页码，默认 1
limit	int	否	每页条数，默认 20，最大 100

返回参数说明

字段	类型	说明
code	int	状态码（0=成功）
msg	string	状态说明
data.aweme_id	string	视频ID
data.total	int	该视频评论总数
data.page	int	当前页码
data.limit	int	每页条数
data.video	object	视频信息（id/aweme_id/title/comment_count）
data.list[].cid	string	评论ID
data.list[].text	string	评论文字
data.list[].nickname	string	用户昵称
data.list[].uid	string	用户抖音UID
data.list[].short_id	string	用户短ID
data.list[].picurl	string	用户头像
data.list[].create_time_text	string	评论时间（格式化）
data.list[].reply_comment_total	int	回复数

请求示例

# 查询已入库评论
curl "https://api.sjz.life/list?token=YOUR_TOKEN&aweme_id=7645880385793141669&page=1&limit=20"

返回示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "aweme_id": "7645880385793141669",
    "total": 156,
    "page": 1,
    "limit": 20,
    "video": {
      "id": 1,
      "aweme_id": "7645880385793141669",
      "title": "",
      "comment_count": 156
    },
    "list": [
      {
        "cid": "7460123456789012345",
        "text": "健康科普很有用",
        "reply_comment_total": 3,
        "create_time": 1780205400,
        "create_time_text": "2026-06-01 14:30:00",
        "uid": "123456789",
        "nickname": "阳光健康",
        "short_id": "2824945355",
        "picurl": "https://p3.douyinpic.com/..."
      }
    ]
  }
}

GET/me

查询当前 Token 的配额和用量

请求参数

参数	类型	必填	说明
token	string	是	接口调用凭证

返回参数说明

字段	类型	说明
code	int	状态码
msg	string	状态说明
data.name	string	接口用户名称
data.daily_limit	int	每日调用上限（0=不限）
data.used_today	int	今日已用次数
data.total_limit	int	累计调用上限（0=不限）
data.used_total	int	累计已用次数
data.start_time	int	生效时间戳（0=立即）
data.end_time	int	到期时间戳（0=长期）
data.status	int	1=启用，0=禁用

请求示例

# 查询配额
curl "https://api.sjz.life/me?token=YOUR_TOKEN"

返回示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "name": "数据合作方A",
    "daily_limit": 1000,
    "used_today": 25,
    "total_limit": 50000,
    "used_total": 1320,
    "start_time": 1717200000,
    "end_time": 1748736000,
    "status": 1
  }
}

GET/health

健康检查

请求示例

curl https://api.sjz.life/health

返回示例

{"code":0,"php_version":"8.2.31"}

错误码

错误码	说明
0	成功
403	Token 无效或已禁用
429	请求超过配额限制
404	接口不存在
500	服务器内部错误

PHP 调用示例

<?php
$token = 'YOUR_TOKEN';
$aweme_id = '7645880385793141669';

// 获取评论
$url = "https://api.sjz.life/list?token={$token}&aweme_id={$aweme_id}&page=1&limit=10";
$resp = file_get_contents($url);
$data = json_decode($resp, true);

if ($data['code'] === 0) {
    foreach ($data['data']['list'] as $comment) {
        echo $comment['nickname'] . ': ' . $comment['text'] . PHP_EOL;
    }
}