API 文档

播放量查询

GET

/dy/search/v3

接口说明

用于查询抖音视频的播放量等统计数据。

请求头

参数名	类型	必填	说明
userkey	string	是	用户的唯一标识

请求参数

参数名	类型	必填	说明
aweme_ids	string	是	抖音视频ID, 多个ID用英文逗号分隔,最多支持2个ID
needInfo	string	否	是否需要详细信息，设置为"1"时返回视频的详细信息，但会增加响应时间至2-3秒

响应示例

基础响应（needInfo未设置或为0）：

            
    {
        "code": 200,
        "params": {
            "aweme_ids": "7503534815414668604,7503505032089685263"
        },
        "data": {
            "statistics_list": [
                {"aweme_id": "7503534815414668604", "digg_count": 1, "play_count": 41},
                {"aweme_id": "7503505032089685263", "digg_count": 3, "play_count": 18}
            ]
        }
    }

详细信息响应（needInfo=1）：

            
    {
        "code": 200,
        "params": {
            "aweme_ids": "7534205558443527451",
            "needInfo": "1"
        },
        "data": {
            "statistics_list": [
                {
                    "aweme_id": "7534205558443527451",
                    "digg_count": 3120,
                    "play_count": 23972,
                    "share_count": 5,
                    "detail_info": {
                        "aweme_detail": {
                            "desc": "过把飞行汽车模架瘾，咱将整本驾照去。 #蒋昌建深度体验飞行汽车##汽车之家顶极片场全球首发##顶极片场是真的顶# 过瘾过程会在8月3日全网上线。😁😁😁",
                            "author": {
                                "nickname": "蒋昌建",
                                "signature": "复旦大学副教授；《最强大脑》主持人",
                                "avatar_thumb": {...}
                            },
                            "video": {
                                "duration": 69366,
                                "play_addr": {...}
                            },
                            "statistics": {
                                "play_count": 23972,
                                "digg_count": 3120,
                                "comment_count": 103,
                                "share_count": 26
                            }
                            // ... 更多详细信息
                        }
                    }
                }
            ]
        }
    }

错误码说明

错误码	说明
401	未提供用户密钥或密钥无效
403	用户已被禁用或超出使用限制
500	服务器内部错误

调用示例

基础查询：

curl -X GET "https://api.suzdata.com/dy/search/v3?aweme_ids=7123456789012345678" \
     -H "userKey: YOUR_USER_KEY" \
     -H "Content-Type: application/json"

查询详细信息（响应时间2-3秒）：

curl -X GET "https://api.suzdata.com/dy/search/v3?aweme_ids=7123456789012345678&needInfo=1" \
     -H "userKey: YOUR_USER_KEY" \
     -H "Content-Type: application/json"

注意：

请确保在请求头中正确设置 userKey，否则将返回 401 错误
每次请求都会消耗一次 API 调用次数
支持批量查询，多个视频ID用逗号分隔，但最多支持2个ID
当设置 needInfo=1 时，会返回视频的详细信息，包括作者信息、视频详情等，但响应时间会增加至2-3秒
详细信息包含在 statistics_list 中每个视频对象的 detail_info 字段内

查询用户统计信息

GET

/api/user/stats

接口说明

用于查询用户的 API 调用统计信息，包括今日调用次数、本月调用次数、总限制、已使用次数、剩余次数以及调用历史记录。

请求头

参数名	类型	必填	说明
userkey	string	是	用户的唯一标识

响应示例

{
    "code": 200,
    "message": "success",
    "data": {
        "todayCalls": 3,
        "monthCalls": 3,
        "totalLimit": 220,
        "usedCount": 212,
        "remainingCalls": 8,
        "history": [
            {
                "time": "2025-10-14T04:51:45.883Z",
                "api": "/dy/search/v3/multi?aweme_ids=7534205558443527451&needInfo=1",
                "status": "成功",
                "calls": 1
            },
            {
                "time": "2025-10-14T04:50:53.538Z",
                "api": "/dy/search/v3/multi?aweme_ids=7534205558443527451&needInfo=1",
                "status": "成功",
                "calls": 1
            }
        ]
    }
}

响应字段说明

字段名	类型	说明
todayCalls	number	今日调用次数
monthCalls	number	本月调用次数
totalLimit	number	总限制次数
usedCount	number	已使用次数
remainingCalls	number	剩余调用次数
history	array	调用历史记录，包含时间、API路径、状态和调用次数

错误码说明

错误码	说明
401	未提供用户密钥或密钥无效
403	用户已被禁用
500	服务器内部错误

调用示例

curl -X GET "https://api.suzdata.com/api/user/stats" \
     -H "userKey: YOUR_USER_KEY" \
     -H "Content-Type: application/json"

注意：

请确保在请求头中正确设置 userKey，否则将返回 401 错误
history 数组按时间倒序排列，最新的调用记录在前
调用历史记录包含完整的 API 路径和参数