查询内容详情_文档中心_MCNDATA数据开放平台

查询内容详情

接口描述

通过内容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"
    }
}复制