# 百度搜索 API 指南总目录
> 接口：百度搜索（apiCode=3351，接入点 3351-1）· 官方自营 · 昆明秀派科技有限公司
> 请求方式：POST / GET · 返回格式：JSON · **最后实测核对：2026-09-15**
百度搜索 API 一次调用返回 10 到 50 条全网网页结果，每条带标题、摘要、正文片段、发布时间、站点名称、权威性评分与相关性评分。接口地址是 `https://route.showapi.com/3351-1?appKey={your_appKey}`，只有 `query` 一个必填参数。
这 8 篇覆盖三件事：怎么先把请求跑通、结果里的字段怎么用、以及把结果接进 RAG、做信源控制、算清调用成本时的具体做法。每篇都带 2026-09-15 的真实调用记录。
---
## 入门层
**1. [百度搜索 API：用 Python 跑通第一次实时检索](https://www.showapi.com/guides/baidu-search-api-quickstart-3351)**
从拿 AppKey 到打印出第一条结果，含 Python / cURL / Node.js 三种写法和真实响应耗时。
**2. [百度搜索 API 返回字段：references 里 13 个字段逐个说清](https://www.showapi.com/guides/baidu-search-api-response-fields-3351)**
字段速查表。含文档没列、实测却每条都返回的 `markdown_content`，以及 `authority_score` / `rerank_score` 的用法。
**3. [百度搜索 API 报错怎么查：query 为空、appKey err、ret_code 各是什么](https://www.showapi.com/guides/baidu-search-api-error-codes-3351)**
三层错误结构（系统级 / 业务级 / 文本描述）对照，含三种错误的真实响应原文和排查顺序。
## 场景实战层
**4. [在 RAG 里接入百度搜索 API：references 从过滤到注入的三步设计](https://www.showapi.com/guides/baidu-search-api-rag-agent-3351)**
检索结果去重、按评分过滤、拼成带引用角标的上下文，附 token 预算取舍。
**5. [百度搜索 API 域名过滤只需两个参数：白名单与黑名单的实测边界](https://www.showapi.com/guides/baidu-search-api-domain-filter-3351)**
同参数对照实测，看黑名单生效后条数怎么变——这点文档没写。
**6. [百度搜索 API 时间过滤实测：四个档位分别返回什么日期的结果](https://www.showapi.com/guides/baidu-search-api-recency-filter-3351)**
week / month / semiyear / year 四档的实测日期分布，以及"不能自定义时间区间"这个边界。
## 技术深挖层
**7. [百度搜索 API 计费与缓存：失败请求扣不扣费，重复 query 要不要缓存](https://www.showapi.com/guides/baidu-search-api-billing-cache-3351)**
`showapi_fee_num` 的实测口径 + Redis 缓存键设计 + 幂等思路。
## 选型对比层
**8. [AI 实时检索选型：百度搜索 API、自建爬虫、免费接口三方对比](https://www.showapi.com/guides/baidu-search-api-compare-3351)**
三条路线的成本、稳定性、维护量对比，也写明什么情况下不该用这个接口。
---
## 相关资源
| 资源 | 地址 |
|------|------|
| 接口详情页 | https://www.showapi.com/apiGateway/view/3351 |
| 接入点文档 | https://www.showapi.com/apiGateway/view/3351/1 |
| OpenAPI YAML | https://www.showapi.com/openapi/market/3351.yaml |
| MCP 服务配置 | `http://www.showapi.com.cn/mcp/3351/{your_appKey}` |
| AppKey | 登录后在我的账号 → 控制台查看 |
---
## 阅读建议
- **第一次用**：按 1 → 2 → 3 的顺序走，先把请求跑通、再弄清返回字段、最后装一份错误对照表。
- **接 AI 应用**：直接看 4，需要控制信源再加 5 和 6。
- **在做技术选型**：先看 8，里面也写了这个接口做不到的事。
- **调用量上来了**：看 7，缓存键怎么设计直接决定账单。
---
- **本系列共 8 篇**：你现在在总目录页，上面已列出全部文章。
