获取视频维度下按天统计的地理位置播放量

更新时间：2023-03-28

1. v3版本

接口描述
该接口用于获取视频维度下按天统计的地理位置相关的播放量数据，该版本接口返回结果中增加了微信小程序终端相关的数据内容。
请求地址
https://spark.bokecc.com/api/stats/playcount/video/daily/location/v3
请求方式
GET
请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

名称 类型 必填 描述
userid String 是 用户ID。
videoid String 是 视频ID。
start_date String 是 查询开始日期（含），日期不能超过查询结束日期，格式：yyyy-MM-dd。
end_date String 是 查询结束日期（含），日期不能超过今日，格式：yyyy-MM-dd。
注：end_date与start_date之间的差值最多为30天。
请求示例
https://spark.bokecc.com/api/stats/playcount/video/daily/location/v3?end_date=2023-03-24&start_date=2023-03-01&userid=xxx&videoid=yyy&time=1679907185654&hash=6E7AE3ADBB0E7F8ECB162D3D1440FD52
返回数据
名称 类型 说明
play_counts Object 播放量。
play_counts说明
名称 类型 说明
play_count Array 播放量信息。
play_count说明
名称 类型 说明
province String 地区(省份)名称，中文。
flash Long 该地区的Flash端播放量。
pc_h5 Long 该地区的H5-PC端播放量。
android Long 该地区的Android端播放量。
ios Long 该地区的iOS端播放量。
mobile_h5 Long 该地区的H5-移动端播放量。
wechat Long 该地区的微信小程序端播放量。
cities Array 该地区下辖的城市数据列表。
cities说明
名称 类型 说明
city String 城市名称，中文。
flash Long 该城市的Flash端播放量。
pc_h5 Long 该城市的H5-PC端播放量。
android Long 该城市的Android端播放量。
ios Long 该城市的iOS端播放量。
mobile_h5 Long 该城市的H5-移动端播放量。
wechat Long 该城市的微信小程序端播放量。
返回示例
{
    "play_counts": {
        "play_count": [{
            "province": "河北省",
            "flash": 10000,
            "pc_h5": 10000,
            "android": 10000,
            "ios": 10000,
            "mobile_h5": 7000,
            "wechat": 30,
            "cities": [{
                "city": "沧州",
                "flash": 1000,
                "pc_h5": 1000,
                "android": 1000,
                "ios": 1000,
                "mobile_h5": 700,
                "wechat": 5
            }]
        }]
    }
}

2. v2版本

接口描述
该接口用于获取视频维度下按天统计的地理位置相关的播放量数据，该版本接口返回结果中详细区分了各播放器终端类型的数据。
请求地址
https://spark.bokecc.com/api/stats/playcount/video/daily/location/v2
请求方式
GET
请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

名称 类型 必填 描述
userid String 是 用户ID。
videoid String 是 视频ID。
start_date String 是 查询开始日期（含），日期不能超过查询结束日期，格式：yyyy-MM-dd。
end_date String 是 查询结束日期（含），日期不能超过今日，格式：yyyy-MM-dd。
注：end_date与start_date之间的差值最多为30天。
请求示例
https://spark.bokecc.com/api/stats/playcount/video/daily/location/v2?end_date=2016-10-19&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1671605641963&userid=CC443A6686737xxx&hash=5D0AA2BFD33445B9BFD8816C07683E0C&start_date=2016-10-18
返回数据
名称 类型 说明
play_counts Object 播放量。
play_counts说明
名称 类型 说明
play_count Array 播放量信息。
play_count说明
名称 类型 说明
province String 地区(省份)名称，中文。
flash Long 该地区的Flash端播放量。
pc_h5 Long 该地区的H5-PC端播放量。
android Long 该地区的dAndroid端播放量。
ios Long 该地区的iOS端播放量。
mobile_h5 Long 该地区的H5-移动端播放量。
cities Array 该地区下辖的城市数据列表。
cities说明
名称 类型 说明
city String 城市名称，中文。
flash Long 该城市的Flash端播放量。
pc_h5 Long 该城市的H5-PC端播放量。
android Long 该城市的Android端播放量。
ios Long 该城市的iOS端播放量。
mobile_h5 Long 该城市的H5-移动端播放量。
返回示例
{
    "play_counts": {
        "play_count": [{
            "province": "河北省",
            "flash": 10000,
            "pc_h5": 10000,
            "android": 10000,
            "ios": 10000,
            "mobile_h5": 7000,
            "cities": [{
                "city": "沧州",
                "flash": 1000,
                "pc_h5": 1000,
                "android": 1000,
                "ios": 1000,
                "mobile_h5": 700
            }]
        }]
    }
}

3. v1版本

接口描述
该接口用于获取视频维度下按天统计的地理位置相关的播放量数据，该版本接口返回结果中只区分了PC端和移动端的数据。
请求地址
https://spark.bokecc.com/api/stats/playcount/video/daily/location
请求方式
GET
请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

名称 类型 必填 描述
userid String 是 用户ID。
videoid String 是 视频ID。
start_date String 是 查询开始日期（含），日期不能超过查询结束日期，格式：yyyy-MM-dd。
end_date String 是 查询结束日期（含），日期不能超过今日，格式：yyyy-MM-dd。
注：end_date与start_date之间的差值最多为30天。
请求示例
https://spark.bokecc.com/api/stats/playcount/video/daily/location?end_date=2016-10-19&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1671605641963&userid=CC443A6686737xxx&hash=5D0AA2BFD33445B9BFD8816C07683E0C&start_date=2016-10-18
返回数据
名称 类型 说明
play_counts Object 播放量。
play_counts说明
名称 类型 说明
play_count Array 播放量信息。
play_count说明
名称 类型 说明
province String 地区(省份)名称，中文。
pc Long 该地区的PC端播放量。
mobile Long 该地区的移动端播放量。
cities Array 该地区下辖的城市数据列表。
cities说明
名称 类型 说明
city String 城市名称，中文。
pc Long 该城市的PC端播放量。
mobile Long 该城市的移动端播放量。
返回示例
{
    "play_counts": {
        "play_count": [{
            "province": "河北省",
            "pc": 100000,
            "mobile": 50000,
            "cities": [{
                "city": "沧州",
                "pc": 10000,
                "mobile": 3000
            }]
        }, {
            "province": "台湾省",
            "pc": 30000,
            "mobile": 2000,
            "cities": []
        }]
    }
}

results matching ""

    No results matching ""