查询内容详情

接口描述

通过内容ID查询标题,发布账号,播放数等详细信息。

请求地址

接口地址:https://api.shuwen.com/mcndata/content/detail

请求方式:GET

请求头

参数 是否必填 类型 描述
sw-access-key 必填 String AccessKey

请求参数

参数 是否必填 类型 描述
timestamp 必填 Long 毫秒级时间戳
signature 必填 String 签名信息,详见接口鉴权
cid 必填 String 内容ID

响应结果

以下仅列出了接口响应结果,公共响应结果见请求响应结果

字段 允许为空 类型 描述
cid String 内容ID
title String 内容标题
url String 内容播放页地址
thumbnail String 内容封面
publish String 内容发布时间
platform String 内容发布平台
play_count Integer 内容播放数,抖音平台为空
like_count Integer 内容点赞数,部分平台为空
data_update_time String 内容数据更新时间
video_duration Integer 视频时长
+media Object 发布账号信息
└media.mid String 发布账号ID
└media.name String 发布账号名称
└media.avatar String 发布账号头像
└media.is_verified Integer 发布账号认证状态,1为认证账号,0为未认证账号

请求额度

单个应用每日的请求次数如下:

应用状态 请求额度
体验 10次/天
正式 50,000次/天

请求示例

下面使用Python实现该接口调用,开发者可以参考实现其他语言的版本。

import requests
import time
import hashlib

# 应用ak和sk
access_key = "YOUR_ACCESS_KEY"
secret_key = "YOUR_SECRET_KEY"

# 13位的当前时间戳
timestamp = round(time.time() * 1000)


# 生成签名
def getSignature(access_key, secret_key, timestamp):
    temp = secret_key + str(timestamp) + access_key
    return hashlib.md5(temp.encode(encoding="UTF-8")).hexdigest()

# 签名后的字符串
signature = getSignature(access_key, secret_key, timestamp)

# 请求url
url = "https://api.shuwen.com/mcndata/content/detail"

# 请求头
headers = {
  "sw-access-key": access_key
}

# 请求参数
params = {
    "timestamp": timestamp,
    "signature": signature,
    "cid": "1268184537251328000"  # 内容ID
}

# 发起http请求
response = requests.get(url, params=params, headers=headers)
print(response.content.decode("utf8"))复制

响应示例

{
    "success": true,
    "code": "0",
    "msg": "Success",
    "requestId": "http-nio-8080-exec-163_2965be5839f949838a2d9abaa72db30c",
    "data": {
        "video_duration": 1044000,
        "data_update_time": "2020-06-18 00:13:18",
        "thumbnail": "https://mcn.newscdn.cn/cover/content/20200603/6198aa4a0ccc081a49622e9534ea2bfd.jpg",
        "like_count": 245279,
        "publish": "2020-06-03 21:24:00",
        "media": {
            "name": "李子柒",
            "mid": "502334",
            "avatar": "https://mcn.newscdn.cn/cover/media/20200413/0ce66ef329963adc9d3b76ff837a0f82.jpg",
            "is_verified": 1
        },
        "play_count": 2562340,
        "title": "【土豆的花样吃法】农耕之乐,劳作之美,饮食之道——土豆的一生",
        "platform": "bilibili",
        "url": "https://www.mcndata.cn/link/25qQZsdcGtK0",
        "cid": "1268184537251328000"
    }
}复制