请求方式:GET
最多获取40条推荐视频
url参数:
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -400:请求错误 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | |
data | array | 推荐列表 |
data
数组:
项 | 类型 | 内容 | 备注 |
---|---|---|---|
0 | obj | 推荐视频1 | |
n | obj | 推荐视频(n+1) | |
…… | obj | …… | …… |
39 | obj | 推荐视频40 |
data
数组中的对象:
基本同「视频详细信息」中的data对象
示例:
查询视频av7
/BV1xx411c7m9
的推荐视频列表
avID方式:
curl -G 'http://api.bilibili.com/x/web-interface/archive/related'\
--data-urlencode 'aid=7'
bvID方式:
curl -G 'http://api.bilibili.com/x/web-interface/archive/related'\
--data-urlencode 'bvid=BV1xx411c7m9'
查看响应示例:
{
"code": 0,
"message": "0",
"ttl": 1,
"data": [{
"aid": 21322566,
"videos": 1,
"tid": 124,
"tname": "趣味科普人文",
"copyright": 1,
"pic": "http://i2.hdslb.com/bfs/archive/37f383ac35d386af1fc578108ad643e5952ff66a.jpg",
"title": "bilibili上市宣传视频",
"pubdate": 1522205992,
"ctime": 1522205994,
"desc": "今天晚上9点30分(北京时间),bilibili将在美国纳斯达克(NASDAQ)证券交易所挂牌上市。",
"state": 0,
"attribute": 16768,
"duration": 155,
"rights": {
"bp": 0,
"elec": 0,
"download": 0,
"movie": 0,
"pay": 0,
"hd5": 1,
"no_reprint": 1,
"autoplay": 1,
"ugc_pay": 0,
"is_cooperation": 0,
"ugc_pay_preview": 0,
"no_background": 0
},
"owner": {
"mid": 208259,
"name": "陈睿",
"face": "http://i2.hdslb.com/bfs/face/8920e6741fc2808cce5b81bc27abdbda291655d3.png"
},
"stat": {
"aid": 21322566,
"view": 2129084,
"danmaku": 51108,
"reply": 18119,
"favorite": 46524,
"coin": 85223,
"share": 16669,
"now_rank": 0,
"his_rank": 1,
"like": 95621,
"dislike": 0
},
"dynamic": "今天晚上9点30分(北京时间),bilibili将在美国纳斯达克(NASDAQ)证券交易所挂牌上市。",
"cid": 35063529,
"dimension": {
"width": 1920,
"height": 1080,
"rotate": 0
},
"bvid": ""
}, {
"aid": 271,
"videos": 1,
"tid": 53,
"tname": "",
"copyright": 1,
"pic": "http://i1.hdslb.com/bfs/archive/a5980672f3d03e8292148748a63de99cd45679d3.jpg",
"title": "弹幕测试专用",
"pubdate": 1249886475,
"ctime": 1497344798,
"desc": "给职人发射弹幕定位用.",
"state": 0,
"attribute": 32768,
"duration": 4558,
"rights": {
"bp": 0,
"elec": 0,
"download": 0,
"movie": 0,
"pay": 0,
"hd5": 0,
"no_reprint": 0,
"autoplay": 1,
"ugc_pay": 0,
"is_cooperation": 0,
"ugc_pay_preview": 0,
"no_background": 0
},
"owner": {
"mid": 2,
"name": "碧诗",
"face": "http://i1.hdslb.com/bfs/face/3e60b20604b6fdc7d081eb6a1ec72aa47c5a3964.jpg"
},
"stat": {
"aid": 271,
"view": 2532266,
"danmaku": 699214,
"reply": 10224,
"favorite": 34927,
"coin": 9712,
"share": 3586,
"now_rank": 0,
"his_rank": 182,
"like": 27257,
"dislike": 0
},
"dynamic": "",
"cid": 3659795,
"dimension": {
"width": 0,
"height": 0,
"rotate": 0
},
"bvid": ""
}, {
"aid": 106,
"videos": 1,
"tid": 26,
"tname": "音MAD",
"copyright": 2,
"pic": "http://i2.hdslb.com/bfs/archive/34d8fdf08d1fe28c229dec2fd122815a1d012908.jpg",
"title": "最终鬼畜蓝蓝路",
"pubdate": 1350316631,
"ctime": 1497348932,
"desc": "sm2057168 把这个音mad的图腾和支柱从UP的怒火中搬出来重新立好,这是我所能做的最后的事情了。",
"state": 0,
"attribute": 32768,
"duration": 318,
"rights": {
"bp": 0,
"elec": 0,
"download": 0,
"movie": 0,
"pay": 0,
"hd5": 0,
"no_reprint": 0,
"autoplay": 1,
"ugc_pay": 0,
"is_cooperation": 0,
"ugc_pay_preview": 0,
"no_background": 0
},
"owner": {
"mid": 8839,
"name": "TSA",
"face": "http://i0.hdslb.com/bfs/face/0ef5daf622bf4789034b3c15147a45e11c48c9b3.jpg"
},
"stat": {
"aid": 106,
"view": 7607070,
"danmaku": 212896,
"reply": 41521,
"favorite": 200705,
"coin": 51673,
"share": 38049,
"now_rank": 0,
"his_rank": 22,
"like": 148550,
"dislike": 0
},
"dynamic": "",
"cid": 3635863,
"dimension": {
"width": 0,
"height": 0,
"rotate": 0
},
"bvid": ""
}, {
"aid": 50025934,
"videos": 1,
"tid": 122,
"tname": "野生技术协会",
"copyright": 1,
"pic": "http://i0.hdslb.com/bfs/archive/af534399612085dbd916381b3377b18c765fab2d.png",
"title": "B站又一位Lv9的up诞生了",
"pubdate": 1555829289,
"ctime": 1555829289,
"desc": "要不关注一下?",
"state": 0,
"attribute": 16512,
"duration": 45,
"rights": {
"bp": 0,
"elec": 0,
"download": 0,
"movie": 0,
"pay": 0,
"hd5": 0,
"no_reprint": 1,
"autoplay": 1,
"ugc_pay": 0,
"is_cooperation": 0,
"ugc_pay_preview": 0,
"no_background": 0
},
"owner": {
"mid": 174161216,
"name": "血色红茶Xenomprph",
"face": "http://i1.hdslb.com/bfs/face/5a5ececb9b7a688751024c60063ba5853bed7e1e.jpg"
},
"stat": {
"aid": 50025934,
"view": 159595,
"danmaku": 62,
"reply": 153,
"favorite": 301,
"coin": 1059,
"share": 55,
"now_rank": 0,
"his_rank": 0,
"like": 1219,
"dislike": 0
},
"dynamic": "",
"cid": 87577929,
"dimension": {
"width": 2560,
"height": 1440,
"rotate": 0
},
"bvid": ""
},
…………
]
}