自然语言搜索接口
更新时间：2025-04-17
自然语言搜索接口
接口说明
将用户输入自然语言转化为机器可理解的查询语言，而非关键字检索，例如用户可输入“高收益且支持现金分红的基金产品”。
请求示例
HTTP方法：POST
请求URL：http://airec.baidu.com/airec/api/language-query
Header如下：
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| Content-Type | - | 是 | application/json;charset=UTF-8 |
| X-Gw-Ak | string | 是 | 推荐服务鉴权信息 |
| Alias-Name | string | 是 | 推荐服务应用名 |
请求格式
POST 方式调用
注意：要求使用 JSON 格式的结构体来描述一个请求的具体内容。
请求参数
| 参数名 | 中文名 | 类型 | 是否必填 | 备注 |
|---|---|---|---|---|
| uid | 用户标识uid | string | 是 | 用户唯一标识 |
| query | 搜索词 | string | 是 | 搜索词 |
| filter | 过滤条件 | dict | 否 | 过滤条件，使用说明可参考自定义筛选使用说明 |
| page_id | 页码 | int | 否 | 页码，默认为1 |
| page_size | 每页返回数量 | int | 否 | 每页返回数量，默认为10 |
| query_source | 搜索来源 | string | 否 | 搜索来源，用于追踪请求来源 |
| scene_key | 场景管理key | string | 否 | 场景管理key，用于获取场景对应的搜索配置 |
| timestamp | 时间戳 | int | 否 | 时间戳 |
请求示例
Plain Text
1{
2 "uid": "xsfe123455",
3 "query": "低风险且支持现金分红的基金"
4}返回格式
JSON格式
返回参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| code | string | 是 | 响应码：0正常，其他异常 |
| message | string | 否 | 响应描述 |
| success | bool | 是 | 请求是否被成功处理 |
| trace_id | string | 是 | 一次请求的唯一标识 |
| result | object | 是 | 返回数据 |
| result.is_success | bool | 是 | 问题是否被回答 |
| result.answer | string | 是 | 问题回答结果 |
| result.item_list | object[] | 是 | 返回的物料列表 |
| result.size | int | 是 | 返回的物料数量 |
| result.time | string | 是 | 请求时间点 |
| result.total | int | 是 | 查询结果总数 |
| result.traceid | string | 是 | 一次请求的唯一标识 |
返回示例
Plain Text
1{
2 "success": true,
3 "message": {
4 "global": "ok"
5 },
6 "code": 0,
7 "result": {
8 "size": 6,
9 "time": "2025-04-17 12:33:51",
10 "total": 6,
11 "traceid": "207683259491340058310980645227791028219-s7qr4",
12 "answer": "{\"query\": {\"bool\": {\"must\": [{\"term\": {\"risk_level.keyword\": \"低风险\"}}, {\"term\": {\"dividend.keyword\": \"现金分红\"}}]}}}",
13 "is_success": true,
14 "item_list": [
15 {
16 "nid": "14429",
17 "title": "[存单AAA指数7天持有期证券投资基金]",
18 "risk_level": "低风险",
19 "dividend": "现金分红"
20 }
21 ]
22 },
23 "trace_id": "207683259491340058310980645227791028219-s7qr4"
24}