百度搜索
概述：可根据用户输入query，搜索全网实时信息，并返回摘要、网址等信息。
计费：每月免费额度为1500次（按天发放），支持按量后付费（为不影响使用体验，可先去开通后付费），默认优先抵扣免费资源。如有其他需求请您联系我们，费用详情请查看计费说明。
使用方式：API、工具及MCP
权限说明
调用本API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
搜索输入。
在百度搜索时，仅支持单轮输入，若传入多轮输入，则以用户传入最后的content为输入查询。
显示子属性
隐藏子属性
角色设定，可选值： user：用户 assistant：模型
content为文本时, 对应对话内容，即用户的query问题。说明：不能为空，长度限制在72个字符以内(一个汉字占两个字符)，输入过长的内容时，只取前72个字符检索
搜索版本。默认为standard。可选值： standard：完整版本。 lite：标准版本，对召回规模和精排条数简化后的版本，时延表现更好，效果略弱于完整版。
使用的搜索引擎版本。固定值：baidu_search_v2
支持设置网页、视频、图片、阿拉丁搜索模态，网页top_k最大取值为50，视频top_k最大为10，图片top_k最大为30，阿拉丁top_k最大为5，默认值为： [{"type": "web","top_k": 20},{"type": "video","top_k": 0},{"type": "image","top_k": 0},{"type": "aladdin","top_k": 0}] 使用阿拉丁时注意：
- 阿拉丁不支持站点、时效过滤。
- 建议搭配网页模态使用，增加搜索返回数量。
- 阿拉丁的返回参数为beta版本，后续可能变更。
显示子属性
隐藏子属性
搜索资源类型。可选值： web：网页 video：视频 image：图片 aladdin：阿拉丁
指定模态最大返回个数。
根据SearchFilter下的子条件做检索过滤，使用方式参考SearchFilter表详情。
显示子属性
隐藏子属性
条件查询
显示子属性
隐藏子属性
支持设置指定站点的搜索条件，即仅在设置的站点中进行内容搜索。目前支持设置100个站点。示例：["tieba.baidu.com","baike.baidu.com"] 注意：此为付费功能，目前限时免费中。
图片过滤参数
显示子属性
隐藏子属性
图片尺寸大小，默认值0，枚举值范围:
0-全部尺寸
4-小图 1px～300px
5-中图 300px～600px
6-大图 600～1080px
7-超大图 1080px以上
图片比例，默认值0，枚举值范围:
0-全部比例
1-细长竖图
2-竖图
3-方图
4-横图
5-细长横图
图片格式，默认值0，枚举值范围:
0-全部格式
2-BMP
3-JPG
4-PNG
5-JPEG
6-GIF
范围查询。可以用于数值型、日期型的字段。语法格式如下： "range": { "{field}": { "gte": "{lowerBound}", "gt": "{lowerBound}", "lte": "{upperBound}", "lt": "{upperBound}" } } 实体(field) pageTime：发布时间的实体名，表示针对pageTime做范围查询。此处pageTime对应响应数据中的page_time字段。网页发布时间的筛选功能只适用于可利用与可展现库，其他结果如视频等不召回。
查询范围(lowerBound\upperBound)
1.指定日期 指定搜索日期范围，格式：YYYY-MM-DD，例如： "range": { "page_time": { "gte": "2025-11-01", "lte": "2025-11-04" } } 2.固定套餐 支持的时间单位：y（年）、M（月）、w（周）、d（日）。目前提供如下固定套餐，其他值非法。其中，"now"表示当前时间，在now后可以添加数学表达式：“-1w”表示减1周；“-1M”表示减1月；“-1y”表示减1年；“/d”表示归一化到当前天的起始\结束时间。
- now/d
- now-1w/d：一周
- now-2w/d：两周
- now-1M/d：一个月
- now-3M/d：三个月
- now-6M/d：六个月
- now-1y/d：一年
参数限制说明： 1.lte使用注意：range范围会参与检索系统的cache key计算，lte在做向上归一舍入后，由于cache可能导致结果时效性落后于match指定的lte值。 2.起始(lowerBound)和截止（upperBound）时间必需同时存在，否则该功能不生效。 3.gte和gt只传其中一个即可，都传只生效gt；lte和lt只传其中一个即可，都传只生效lt。
显示子属性
隐藏子属性
假设下述的now时间是2024-07-16。 示例如下： 查询当天前7天(不含当天)发布的网页结果： "query": { "filter": { "range": { "page_time": { "gte": "now-1w/d" "lt": "now/d" } } } }
显示子属性
隐藏子属性
时间查询参数，大于或等于。"now-1w/d"，2024-07-16前一周、向下做舍入，即大于2024-07-09 00:00:00，包含2024-07-09完整天。
时间查询参数，大于。"now-1w/d"，2024-07-16前一周、向上做舍入，即大于2024-07-09 23:59:59，不包含2024-07-09完整天。
时间查询参数，小于或等于。"now-1w/d"，2024-07-16前一周、向上做舍入，即小于2024-07-09 23:59:59，包含2024-07-09完整天。
时间查询参数，小于。"now-1w/d"，2024-07-16前一周、向下做舍入，即小于2024-07-09 00:00:00，不包含2024-07-09完整天。
地理位置信息
显示子属性
隐藏子属性
城市；当前仅支持传入一个城市，直辖市不支持指定区级行政区：
- 普通城市：沈阳
- 直辖市：北京
显示子属性
隐藏子属性
需要屏蔽的站点列表。过滤站点列表中属于该站点与该站点下子站点的搜索结果。 示例：["tieba.baidu.com"]
根据网页发布时间进行筛选。枚举值: week:最近7天 month：最近30天 semiyear：最近180天 year：最近365天
是否开启安全搜索，默认false。
开启后将采用更严格的风控策略，部分可能涉黄、涉恐query将不返回搜索结果。
query干预配置项的配置ID，默认为空。传入时，会根据config_id中的策略进行query干预
排序参数
显示子属性
隐藏子属性
默认为空，可选值： auto;
空：采用默认规则
auto：根据query类型自动排序，强时效性问题建议采用该策略，如：今日原油价格
POST /v2/ai_search/web_search HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"messages": [
{
"content": "北京有哪些旅游景区",
"role": "user"
}
],
"search_source": "baidu_search_v2",
"resource_type_filter": [{"type": "web","top_k": 20}],
"search_filter": {
"match": {
"site": [
"www.weather.com.cn"
]
}
},
"search_recency_filter": "year"
}```示例代码
curl --location 'https://qianfan.baidubce.com/v2/ai_search/web_search' \
--header 'X-Appbuilder-Authorization: Bearer <AppBuilder API Key>' \
--header 'Content-Type: application/json' \
--data '{
"messages": [
{
"content": "百度千帆平台",
"role": "user"
}
],
"search_source": "baidu_search_v2",
"resource_type_filter": [{"type": "web","top_k": 10}]
}'返回响应
请求ID。
错误码，当发生异常时返回。
错误消息，当发生异常时返回。
模型回答详情列表，参考Reference对象表详情。
显示子属性
隐藏子属性
网站图标地址。
引用编号1、2、3
网页标题
网页地址
网站锚文本或网站标题
站点名称。
搜索接口原文片段（非网页原文）
显示网页片段
网页日期
检索资源类型：
web:网页
image:图像内容
video:视频内容
图片详情
显示子属性
隐藏子属性
图片链接
图片高度
图片宽度
视频详情
显示子属性
隐藏子属性
视频链接
视频高度
视频宽度
视频大小，单位Bytes
视频长度，单位秒
视频封面图
是否为阿拉丁内容。
阿拉丁详细内容，参考文档。
网页相关图片
显示子属性
隐藏子属性
网页相关图片
显示子属性
隐藏子属性
图片链接
图片高度
图片宽度
仅百家号站点存在
显示子属性
隐藏子属性
作者名字
作者签名
作者认证类型
{
"references": [
{
"content": "河北天气预报,及时准确发布中央气象台天气信息,便捷查询河北今日天气\u0004,河北周末天气,河北一周天气预报,河北蓝天预报,河北天气预报,河北40日天气预报,还\u0005提供河北的生活指数、健康指数、交通...",
"date": "2025-04-27 18:02:00",
"icon": null,
"id": 1,
"image": null,
"title": "【河北天气】河北天气预报,蓝天,蓝天预报,雾霾,雾霾...",
"type": "web",
"url": "https://www.weather.com.cn/html/weather/101031600.shtml",
"video": null,
"web_anchor": "【河北天气】河北天气预报,蓝天,蓝天预报,雾霾,雾霾..."
},
{
"content": "保定天气预报,及时准确发布中央气象台天气信息,便捷查询保定今日天气,保定周末天气,保定一周天气预报,保定蓝天预报,保定天气预报,保定40日天气预报,还提供保定的生活指数、健康指数、交通...",
"date": "2025-05-20 11:58:00",
"icon": null,
"id": 2,
"image": null,
"title": "保定天气预报,保定7天天气预报,保定15天天气预报,保定...",
"type": "web",
"url": "https://www.weather.com.cn/weather/101090201.shtml",
"video": null,
"web_anchor": "保定天气预报,保定7天天气预报,保定15天天气预报,保定..."
},
{
"content": "河北省气象台2025年05月23日11时发布天气预报: 今天下午到夜间,保定西部、石家庄西部、邢台西部阴有小雨或零星小雨转晴,其他地区阴转晴。最高气温,张家口、承德北部、保定西北部13～17...",
"date": "2025-05-23 00:00:00",
"icon": null,
"id": 3,
"image": null,
"title": "今天西部部分地区仍有降水 其它地区阴转晴-河北首页...",
"type": "web",
"url": "http://hebei.weather.com.cn/tqxs/4190923_m.shtml",
"video": null,
"web_anchor": "今天西部部分地区仍有降水 其它地区阴转晴-河北首页..."
},
{
"content": "河北省气象台2025年05月22日05时发布天气预报 今天白天,保定、廊坊及以北地区阴有小雨或阵雨,其中张家口、保定西北部有中到大雨;其他地区多云转阴有小雨或阵雨,其中邯郸大部有中雨。...",
"date": "2025-05-22 09:07:22",
"icon": null,
"id": 4,
"image": null,
"title": "今天白天到夜间,我省大部分地区有降水-河北首页-中国...",
"type": "web",
"url": "http://hebei.weather.com.cn/tqxs/4189523_m.shtml",
"video": null,
"web_anchor": "今天白天到夜间,我省大部分地区有降水-河北首页-中国..."
}
],
"request_id": "ca749cb1-26db-4ff6-9735-f7b472d59003"
}{
"requestId": "00000000-0000-0000-0000-000000000000",
"code": 216003,
"message": "Authentication error: ( [Code: InvalidHTTPAuthHeader; Message: Fail to parse apikey authorization; RequestId: ea6ffeca-a136-401b-ba30-61c910c02ead] )"
}| 错误码 | 描述 |
|---|---|
| 400 | 客户端请求参数错误 |
| 500 | 服务端执行错误 |
| 501 | 调用模型服务超时 |
| 502 | 模型流式输出超时 |
| 其它 | 详见模型返回错误码。 |
评价此篇文章