DeepSeek API 有两个独立的联网接口：Search 负责搜网页，返回结构化结果；Fetch 负责抓单个网页，返回 Markdown 正文（官方指南，核对时间 2026 年 11 月 3 日）。它们不是 chat 模型的内置功能，而是单独调用的原始 JSON API，Agent 和 RAG 应用靠它们拿到实时网页内容。这篇把端点、算子、计费、限速一次讲全——计费规则里有一条 11 月生效的变化，用 Claude Code 或 Codex 的要留意。
两个接口各做什么
两个接口共用同一套鉴权（Authorization 头带 Bearer API Key），base_url 都是 https://api.deepseek.com：
| 接口 | 端点 | 做什么 |
|---|---|---|
| Search | POST /v1/tools/search | 给一句查询，返回网页结果数组（标题、网址、摘要、日期等字段） |
| Fetch | POST /v1/tools/fetch | 给一个网址，返回该页正文转成的 Markdown 文本 |
Search 的主要参数：query（1 到 128 个字符，必填）、count（返回条数，1 到 50，默认 10）、need_content（是否返回页面全文，默认 false——只要摘要就别开，开了大响应会慢）、localization（可选 IP 地址，用于结果本地化）。Fetch 只收一个 url：长度不超过 8192 字符、必须是带主机名的 http 或 https 网址、不能带用户名密码。Search 由 DeepSeek 自研搜索引擎驱动，「先搜后答」的通用过程见联网检索是怎么发生的。
Search 的查询算子：八个符号
查询串原样透传给搜索引擎，官方支持这些算子，可组合使用：
| 算子 | 示例 | 作用 |
|---|---|---|
| site: | DeepSeek site:github.com | 限定站点；多站用 OR 连接 |
| -site: | DeepSeek -site:example.com | 排除站点 |
| - | DeepSeek -advertisement | 排除含该词的页面 |
| -"..." | DeepSeek -"release notes" | 排除含该短语的页面 |
| "..." | DeepSeek "exact phrase" | 精确短语匹配 |
| lang: | DeepSeek lang:zh,en | 限定语言（逗号分隔多个） |
| after: | DeepSeek after:2025-01-01 | 只收该日期之后发布的页面 |
| before: | DeepSeek before:2026-06-01 | 只收该日期之前发布的页面 |
查官方公告类信息时，site: 加官网域名、after: 加时间下限的组合最省事，一次就能把范围压到你要的窗口里。
返回结果怎么读：三个字段决定质量
Search 返回的每条结果里，有三个字段值得先看：rerank_score（0 到 3 的综合分，官方口径 1.5 以上算高质量结果）、authority（权威度 0 到 4，3 以上是高权威来源，-1 表示未知）、date（发布时间，UTC，未知时为 null）。内容类字段分三层：snippet 是 100 到 200 字的短摘要（给人看的界面展示用）、summary 是 600 到 800 字的长摘要（给模型读的）、content 是页面全文（need_content 为 false 时恒为空字符串）。给 Agent 排序时，先按 rerank_score 筛再按 authority 断层收窄，比一股脑全塞给模型省得多。
计费规则：按成功请求收，失败不收
两个接口都按成功请求计费，不按 token、不按返回条数：Search 与 Fetch 均为每 1000 次成功请求 0.75 美元。成功的定义有两条：HTTP 返回 200，且 Search 返回非空 results 数组、Fetch 返回页面内容。失败请求、空结果、超时都不计费；count 调大调小不影响单次价格。
一条时效变化要注意：通过 DeepSeek Harness、Claude Code 或 Codex 使用 DeepSeek API 时，服务端工具调用走的就是这两个接口——官方口径是目前免费，北京时间 2026 年 11 月 1 日 0 点起开始按次计费。也就是说编码工具的重度用户，11 月起联网类调用的账单里会多出这一项，量大的先估一下频次。
频率限制与报错处置
限速按账号算，与用哪个 API Key 无关，且与模型并发限制相互独立：
| 接口 | 账号级 QPS | 备注 |
|---|---|---|
| Search | 100 | 超出返回 429 |
| Fetch | 25 | 超出返回 429；另有按目标域名的 QPS 限制 |
报错分支的处置原则（与模型侧错误码的对照见DeepSeek API 报错对照）：408、429、5xx 可以原样重试（等一等再发）；402 是余额不足，先充值再重试；其余 4xx（400 请求体无效、401 密钥无效、403 被安全策略拒绝、404 取不到可用内容、413 请求体过大）不要不改请求就盲目重试——特别是 Fetch 的 404，官方列的触发面包括网址不可用、站点策略阻止、不支持的内容类型、页面没有可提取的 Markdown，换源比重试有用。
常见问题
- 这和 chat 模型的联网开关是一回事吗？不是。模型联网是聊天时自动搜；这两个接口是你在代码里主动调用的独立服务，Agent 流程里由你自己决定何时搜、搜什么、结果怎么用。对话产品里联网开关的行为差异见联网搜索质量一篇。
- 拿它做 RAG 合适吗？合适——这正是官方给的定位（agents and RAG applications）。实时信息用 Search 拿线索、Fetch 抓正文，私有知识库则走本地检索，两套料源的边界见联网检索的过程。
- 429 之后怎么重试？等一秒级间隔再试即可，QPS 是按秒计算的账号级限制；Fetch 还要考虑目标域名的独立限制——同一站抓太快会先撞按域名的 429，给抓取循环加间隔比换 Key 管用（换 Key 没用，限的是账号）。
信息来源
- DeepSeek 官方「Search & Fetch」指南（api-docs.deepseek.com/guides/search，核对时间 2026-11-03）：端点、参数表、八个查询算子、响应字段口径（rerank_score 1.5、authority 3）、计费规则与 11 月 1 日起工具链内计费、错误码分支；
- DeepSeek 官方定价页与「Rate Limit & Isolation」（api-docs.deepseek.com，核对时间 2026-11-03）：Search QPS 100、Fetch QPS 25、按域名限制；
- 站内条目：DeepSeek（工具页）、DeepSeek 模型名怎么填、DeepSeek 的 Responses API。
