查询账号内容列表_文档中心_MCNDATA数据开放平台

查询账号内容列表

接口描述

通过账号ID查询发布的内容数据。

请求地址

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

请求方式：GET

请求头

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

请求参数

参数	是否必填	类型	描述
timestamp	必填	Long	毫秒级时间戳
signature	必填	String	签名信息，详见接口鉴权
mid	必填	String	账号ID
page	必填	Integer	起始页码，默认为1
size	必填	Integer	单页返回条数，10-100 之间，默认20

响应结果

内容列表按发布时间的倒序返回数据，以下仅列出了接口响应结果，公共响应结果见请求响应结果。

字段	允许为空	类型	描述
total_count	否	Integer	符合条件的结果条数
has_more	否	Integer	是否有更多数据，当has_more为1时表示有更多数据，可使用page和size请求参数进行翻页
+list	是	Array	内容列表，无结果时返回空
└list.cid	否	String	内容ID
└list.title	否	String	内容标题
└list.url	否	String	内容播放页地址
└list.thumbnail	否	String	内容封面
└list.publish	否	String	内容发布时间
└list.platform	否	String	内容发布平台
└list.play_count	是	Integer	内容播放数，抖音平台为空
└list.like_count	是	Integer	内容点赞数，部分平台为空
└list.update_time	否	String	内容数据更新时间
└list.video_duration	否	Integer	视频时长
└+list.media	否	Object	发布账号信息
└list.media.mid	否	String	发布账号ID
└list.media.name	否	String	发布账号名称
└list.media.avatar	否	String	发布账号头像
└list.media.is_verified	否	Integer	发布账号认证状态，1为认证账号，0为未认证账号

请求额度

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

应用状态	请求额度
体验	10次/天
正式	10,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/list"

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

# 请求参数
params = {
    "timestamp": timestamp,
    "signature": signature,
    "mid": "502334",  # 账号ID
    "page": 1,      # 起始页数，默认为1
    "size": 20     # 单页条数，默认为20
}

# 发起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-71_5c466d1163d44efe985e82f5f1ff59ff",
    "data": {
        "list": [
            {
                "video_duration": 1044000,
                "thumbnail": "https://mcn.newscdn.cn/cover/content/20200603/6198aa4a0ccc081a49622e9534ea2bfd.jpg",
                "like_count": 245279,
                "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",
                "update_time": "2020-06-18 00:13:18",
                "publish": "2020-06-03 21:24:00",
                "cid": "1268184537251328000"
            },
            {
                "video_duration": 1145000,
                "thumbnail": "https://mcn.newscdn.cn/cover/content/20200519/ece9fadca81a4748bcdf81202aca86ee.jpg",
                "like_count": 273225,
                "media": {
                    "name": "李子柒",
                    "mid": "502334",
                    "avatar": "https://mcn.newscdn.cn/cover/media/20200413/0ce66ef329963adc9d3b76ff837a0f82.jpg",
                    "is_verified": 1
                },
                "play_count": 2325108,
                "title": "【小麦的一生】一株小麦，变化出扎根在每个人记忆里的味道",
                "platform": "bilibili",
                "url": "https://www.mcndata.cn/link/25I2iN8CecAw",
                "update_time": "2020-06-18 00:13:18",
                "publish": "2020-05-19 21:19:04",
                "cid": "1262742931719213056"
            },
            {
                "video_duration": 749000,
                "thumbnail": "https://mcn.newscdn.cn/cover/content/20200501/987e11523fc394f3673cf3e9b299fb15.jpg",
                "like_count": 235487,
                "media": {
                    "name": "李子柒",
                    "mid": "502334",
                    "avatar": "https://mcn.newscdn.cn/cover/media/20200413/0ce66ef329963adc9d3b76ff837a0f82.jpg",
                    "is_verified": 1
                },
                "play_count": 2463608,
                "title": "【豌豆的一生】豌豆大丰收！得闲把豌豆吃食都做个遍",
                "platform": "bilibili",
                "url": "https://www.mcndata.cn/link/24bcZU7qf0H4",
                "update_time": "2020-06-18 00:13:18",
                "publish": "2020-04-30 20:00:17",
                "cid": "1255948266579841024"
            },
            {
                "video_duration": 747000,
                "thumbnail": "https://mcn.newscdn.cn/cover/content/20200414/333174aaeb821861f91f090ebf49078a.jpg",
                "like_count": 260786,
                "media": {
                    "name": "李子柒",
                    "mid": "502334",
                    "avatar": "https://mcn.newscdn.cn/cover/media/20200413/0ce66ef329963adc9d3b76ff837a0f82.jpg",
                    "is_verified": 1
                },
                "play_count": 2964076,
                "title": "【大蒜】一棵蒜苗的一生，最难割舍的家常滋味——大蒜",
                "platform": "bilibili",
                "url": "https://www.mcndata.cn/link/241U4urickCW",
                "update_time": "2020-06-18 00:13:18",
                "publish": "2020-04-13 20:50:12",
                "cid": "1249886475684810752"
            },
            {
                "video_duration": 605000,
                "thumbnail": "https://mcn.newscdn.cn/cover/content/20200413/a45f953c1da8497c39775fe20d4b4604.jpg",
                "like_count": 273680,
                "media": {
                    "name": "李子柒",
                    "mid": "502334",
                    "avatar": "https://mcn.newscdn.cn/cover/media/20200413/0ce66ef329963adc9d3b76ff837a0f82.jpg",
                    "is_verified": 1
                },
                "play_count": 2747281,
                "title": "【桃花节】骑马踏青，取花为食，才不辜负春日好时节——上巳节",
                "platform": "bilibili",
                "url": "https://www.mcndata.cn/link/2408CJSnc0X4",
                "update_time": "2020-06-18 00:13:18",
                "publish": "2020-04-02 18:00:31",
                "cid": "1249657273899433984"
            },
            {
                "video_duration": 982000,
                "thumbnail": "https://mcn.newscdn.cn/cover/content/20200413/5a4a3021198b79b2933f43b7a046bee1.jpg",
                "like_count": 372792,
                "media": {
                    "name": "李子柒",
                    "mid": "502334",
                    "avatar": "https://mcn.newscdn.cn/cover/media/20200413/0ce66ef329963adc9d3b76ff837a0f82.jpg",
                    "is_verified": 1
                },
                "play_count": 2290359,
                "title": "【蓝染】印染在花布上的靛蓝，铭刻在骨子里的传承——蓝印花布",
                "platform": "bilibili",
                "url": "https://www.mcndata.cn/link/24086dcGbpHs",
                "update_time": "2020-06-18 00:13:18",
                "publish": "2020-03-22 18:00:46",
                "cid": "1249657008580329472"
            },
            {
                "video_duration": 681000,
                "thumbnail": "https://mcn.newscdn.cn/cover/content/20200413/453a59eb5cc217c3d50b987cbce55d67.jpg",
                "like_count": 0,
                "media": {
                    "name": "李子柒",
                    "mid": "502334",
                    "avatar": "https://mcn.newscdn.cn/cover/media/20200413/0ce66ef329963adc9d3b76ff837a0f82.jpg",
                    "is_verified": 1
                },
                "play_count": 3166016,
                "title": "【棉花】寒夜里最柔软的守护，暖暖的，很贴心——棉被",
                "platform": "bilibili",
                "url": "https://www.mcndata.cn/link/24085JBAecU8",
                "update_time": "2020-04-30 10:36:55",
                "publish": "2020-01-20 18:40:41",
                "cid": "1249656947079262208"
            },
            {
                "video_duration": 664000,
                "thumbnail": "https://mcn.newscdn.cn/cover/content/20200413/ba6c5ed1b72e2892e089bcffd7e017dc.jpg",
                "like_count": 0,
                "media": {
                    "name": "李子柒",
                    "mid": "502334",
                    "avatar": "https://mcn.newscdn.cn/cover/media/20200413/0ce66ef329963adc9d3b76ff837a0f82.jpg",
                    "is_verified": 1
                },
                "play_count": 2816954,
                "title": "【腊肠煲仔饭】当腊味煲仔饭遇上胡椒猪肚鸡，你又以为有故事？还是没有！",
                "platform": "bilibili",
                "url": "https://www.mcndata.cn/link/2408C9FTjcNS",
                "update_time": "2020-04-30 10:36:55",
                "publish": "2020-01-08 18:47:31",
                "cid": "1249657265951223808"
            },
            {
                "video_duration": 671000,
                "thumbnail": "https://mcn.newscdn.cn/cover/content/20200413/e0de8445e61ebab72a97f0bf7e835436.jpg",
                "like_count": 0,
                "media": {
                    "name": "李子柒",
                    "mid": "502334",
                    "avatar": "https://mcn.newscdn.cn/cover/media/20200413/0ce66ef329963adc9d3b76ff837a0f82.jpg",
                    "is_verified": 1
                },
                "play_count": 2608051,
                "title": "【烙锅和缙云烧饼】当烙锅遇上缙云烧饼，你以为有故事？并没有！",
                "platform": "bilibili",
                "url": "https://www.mcndata.cn/link/24085DYvGkcs",
                "update_time": "2020-04-30 10:36:55",
                "publish": "2020-01-01 05:32:00",
                "cid": "1249656942721380352"
            }
        ],
        "total_count": 9,
        "has_more": 0
    }
}
复制