新推荐接口
更新时间：2024-02-22
新推荐接口
接口说明
百度提供的新推荐接口，按照发布时间推荐最新的物料。
请求示例
HTTP方法：POST
请求URL：https://airec.baidu.com/airec/api/rec/n_rec
Header如下：
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| Content-Type | - | 是 | application/json;charset=UTF-8 |
| X-Gw-Ak | string | 是 | 推荐服务鉴权信息 |
| Alias-Name | string | 是 | 推荐服务应用名 |
请求格式
POST 方式调用
注意：要求使用 JSON 格式的结构体来描述一个请求的具体内容。
请求参数
| 参数名 | 中文名 | 类型 | 是否必填 | 备注 |
|---|---|---|---|---|
| uid | 用户标识uid | string | 是 | 用户唯一标志 |
| page_id | 当前推荐页数 | int | 否 | 当前推荐页数 |
| req_cnt | 请求个数 | int | 否 | 单次请求推荐接口获取结果的数量，默认为10 |
| filter | 过滤条件 | dict | 否 | 过滤条件 |
| user_info_str | 用户信息 | string | 否 | {} |
| sort_field | 排序字段 | string | 否 | 排序字段 |
| mapKey | 场景 | string | 否 | 场景 |
请求示例
Plain Text
1{
2 "uid": "xsfe123455",
3 "req_cnt": 2
4}返回格式
JSON格式
返回参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| trace_id | string | 是 | 推荐一次请求的唯一标识 |
| code | string | 是 | 响应码：0正常，其他异常 |
| message | string | 否 | 响应描述 |
| item_list | list | 是 | 返回的物料 nid列表 |
| size | int | 是 | 返回的物料数量 |
返回示例
Plain Text
1{
2 "code": 0,
3 "message": "",
4 "result": {
5 "item_list": [
6 {
7 "channels": [
8 "抖屏游戏"
9 ],
10 "cities": [
11 "beijing"
12 ],
13 "country": "中国",
14 "data_source": "vod",
15 "display_run_time": 61,
16 "epi_type": "program",
17 "expire_time": "1978831694000",
18 "language": "中文",
19 "need_pay": 1,
20 "nid": "9__02000512000000012022032599001774",
21 "operator_id": "CMCC",
22 "operator_name": "移动",
23 "provider_id": "iqiyi",
24 "provider_name": "爱奇艺",
25 "publish_time": "1648561924764",
26 "score": "8.5",
27 "status": 1,
28 "title": "国乐大典 李乐苏园园《万里长城永不倒》",
29 "ts": "1668768945874",
30 "type": "电影",
31 "valid_time": "1648561924764",
32 "view_point": "看点",
33 "year": "2019"
34 },
35 {
36 "actors": [
37 "广东粤剧院"
38 ],
39 "base_tags": [
40 "粤剧"
41 ],
42 "channels": [
43 "戏曲"
44 ],
45 "cities": [
46 "beijing"
47 ],
48 "country": "中国",
49 "data_source": "vod",
50 "desc": "粤剧《八和会馆》描写了清朝同治年间，清政府对本地班禁戏“亡行”之后，以新华为首的年轻粤剧子弟于艰难困苦的绝境中，坚强不屈、矢志不渝，更兼学习领悟当时广东改革创新的思想，终使得官府解除禁戏。粤剧由此复兴而走向繁荣，而新华等更团结起广大粤剧艺人，以创新精神建立起保障艺人权利，组织粤剧生产，和衷共济、共存共荣的“八和会馆”，使得粤剧发展进入到崭新的阶段。",
51 "display_run_time": 61,
52 "epi_type": "program",
53 "expire_time": "1978831694000",
54 "language": "中文",
55 "need_pay": 1,
56 "nid": "9__02000078000000012021062399001883",
57 "op_tags": [
58 "粤剧"
59 ],
60 "operator_id": "CMCC",
61 "operator_name": "移动",
62 "provider_id": "iqiyi",
63 "provider_name": "爱奇艺",
64 "publish_time": "1648561924764",
65 "score": "8.5",
66 "status": 1,
67 "title": "粤剧《八和会馆》黄春强版",
68 "ts": "1668768945863",
69 "type": "电影",
70 "valid_time": "1648561924764",
71 "view_point": "看点",
72 "year": "2019"
73 }
74 ],
75 "size": 2,
76 "time": "2024-02-22 08:00:08",
77 "traceid": "156874020880905940353710878700496761108_hc5sh"
78 },
79 "trace_id": "156874020880905940353710878700496761108_hc5sh"
80}