个性化推荐接口
更新时间：2024-06-07
个性化推荐接口
接口说明
百度提供的个性化推荐接口，结合用户历史行为，推荐当前用户可能感兴趣的物料集合。
请求示例
HTTP方法：POST
请求URL：https://airec.baidu.com/airec/api/rec/p_rec
Header如下：
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| Content-Type | - | 是 | application/json;charset=UTF-8 |
| X-Gw-Ak | string | 是 | 推荐服务鉴权信息 |
| Alias-Name | string | 是 | 推荐服务应用名 |
请求格式
POST 方式调用
注意：要求使用 JSON 格式的结构体来描述一个请求的具体内容。
请求参数
| 参数名 | 中文名 | 类型 | 是否必填 | 备注 |
|---|---|---|---|---|
| uid | 用户标识uid | string | 是 | 用户唯一标志 |
| page_id | 推荐请求的翻页, 默认1 | int | 否 | 当前推荐页数 |
| req_cnt | 推荐数量 | int | 否 | 单次请求推荐接口获取结果的数量，默认为10 |
| channels | 频道 | string | 否 | 频道推荐, 只返回这个频道下的物料,多个值逗号分割,如vod,体育 |
| is_personalized | 是否使用个性化推荐 | int | 否 | 是否使用个性化推荐, 使用为1，不使用为0，默认为1 |
| timestamp | 时间戳 | int | 否 | 支持默认当前时间 |
| city | 当前用户所在城市 | string | 否 | 城市名称或城市编码，如：北京 |
| filter | 过滤条件 | dict | 否 | 过滤条件 |
| scene_key | 场景管理key | string | 否 | 场景管理key |
请求示例1
首页推荐请求示例：
Plain Text
1{
2 "uid": "xsfe123455",
3 "page_id": 1,
4 "req_cnt": 20,
5 "is_personalized": 1
6}请求示例2
频道推荐请求示例： 只返回物料channels字段中包含体育或科技的物料。
Plain Text
1{
2 "uid": "xsfe123455",
3 "page_id": 1,
4 "req_cnt": 20,
5 "channels": "体育,科技"
6}请求示例3
城市推荐请求示例：只推荐物料cities字段包含全国或北京的内容。
Plain Text
1{
2 "uid": "xsfe123455",
3 "page_id": 1,
4 "req_cnt": 20,
5 "city": "北京",
6 "filter": {
7 "cond": "contain",
8 "field": "cities",
9 "value": ["全国", "北京"]
10 }
11}返回格式
JSON格式
返回参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| trace_id | string | 是 | 推荐一次请求的唯一标识 |
| code | string | 是 | 响应码：0正常，其他异常 |
| message | string | 否 | 响应描述 |
| item_list | list | 是 | 返回的物料 nid列表 |
| size | int | 是 | 返回的物料数量 |
| top_list | list | 是 | 置顶的物料 nid列表 |
返回示例
Plain Text
1{
2 "code": 0,
3 "message": "",
4 "result": {
5 "item_list": [
6 "176",
7 "2223",
8 "211",
9 "2046",
10 "0__687639449669",
11 "0__687639449672",
12 "0__687639449671",
13 "0__687639449673",
14 "0__687639449674",
15 "0__687639449675"
16 ],
17 "recall_result": {
18 "搜索需求召回": [
19 "176",
20 "2046"
21 ],
22 "最新发布召回": [
23 "2223",
24 "0__687639449962",
25 "NID_1001",
26 "NID_1002"
27 ],
28 "热门物料召回": [
29 "211",
30 "2046"
31 ],
32 "短期兴趣召回": [
33 "0__687639449673",
34 "0__687639449674"
35 ],
36 "订阅作者召回": [
37 "0__687639449675"
38 ],
39 "语义相似召回": [
40 "0__687639449669",
41 "0__687639449672"
42 ],
43 "长期偏好召回": [
44 "0__687639449671"
45 ]
46 },
47 "size": 10,
48 "time": "2024-06-07 11:15:13",
49 "top_list": [
50 "NID_1003"
51 "NID_1005"
52 ],
53 "traceid": "traceid-lrh67"
54 },
55 "trace_id": "traceid-lrh67"
56}