API 文档

播放量查询

GET

/dy/search/v3

接口说明

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

请求头

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

请求参数

参数名	类型	必填	说明
dy_ids	string	是	抖音视频ID, 多个ID用英文逗号分隔,最多支持2个ID

响应示例(数据没返回则为0)

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

错误码说明

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

调用示例

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

注意：

请确保在请求头中正确设置 userKey，否则将返回 401 错误
每次请求都会消耗一次 API 调用次数
支持批量查询，多个视频ID用逗号分隔，但最多支持2个ID

查询剩余次数

GET

/dy/usage

接口说明

用于查询用户的 API 调用剩余次数。

请求头

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

响应示例

{
    "code": 200,
    "message": "success",
    "data": {
        "total": 1000,
        "used": 100,
        "remaining": 900
    }
}

错误码说明

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

调用示例

curl -X GET "http://api.suzdata.com/dy/usage" \
     -H "userKey: YOUR_USER_KEY" \
     -H "Content-Type: application/json"

注意： 请确保在请求头中正确设置 userKey，否则将返回 401 错误。