搜索接口
更新时间:2024-04-24
搜索接口
接口说明
百度提供的物料搜索接口。
请求示例
HTTP方法:POST
请求URL:http://airec.baidu.com/airec/api/search/main
Header如下:
参数名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
Content-Type | - | 是 | application/json;charset=UTF-8 |
X-Gw-Ak | string | 是 | 推荐服务鉴权信息 |
Alias-Name | string | 是 | 推荐服务应用名 |
请求格式
POST 方式调用
注意:要求使用 JSON 格式的结构体来描述一个请求的具体内容。
请求参数
参数名 | 中文名 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
uid | 用户标识uid | string | 是 | 用户唯一标识 |
query | 搜索词 | string | 是 | 搜索词 |
page_id | 页码 | int | 否 | 页码,默认为1 |
page_size | 每页返回数量 | int | 否 | 每页返回数量,默认为10 |
filter | 过滤条件 | dict | 否 | 过滤条件 |
enable_personalized_rank | 是否启用个性化排序 | bool | 否 | 是否启用个性化排序 |
need_correct | 是否启用纠错 | bool | 否 | 是否启用纠错 |
need_synonym | 是否启用同义词 | bool | 否 | 是否启用同义词 |
sort_field | 排序字段 | string | 否 | 后置排序字段,如果设置了,会将返回的物料根据该字段排序 |
reverse | 是否逆序排列 | bool | 否 | 是否逆序排列, 默认为true |
field_weight | 搜索权重 | dict | 否 | 需要搜索的字段及语义分打分权重 |
query_source | 搜索来源 | string | 否 | 搜索来源 |
请求示例
{
"uid": "xsfe123455",
"query": "王维"
}
返回格式
JSON格式
返回参数
参数名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
code | string | 是 | 响应码:0正常,其他异常 |
message | string | 否 | 响应描述 |
trace_id | string | 是 | 推荐一次请求的唯一标识 |
size | int | 是 | 返回的物料数量 |
item_list | list | 是 | 返回的物料nid列表 |
返回示例
{
"code": 0,
"message": "",
"trace_id": "jfldjflajfldsajflsa",
"result": {
"size": 3,
"item_list": ['13453611549650700466', '231359537527085656', '12235609175035395475']
}
}