DeepSeek 的搜索 API 与抓取 API 是一对工具：搜索 API 负责按关键词找网页，返回标题、链接、摘要、日期和质量评分；抓取 API 负责把单个网页取回来，转成 Markdown 交给模型或检索流程。两个接口都用与 DeepSeek 对话 API 相同的密钥，走原始 JSON 请求，不经过聊天模型。计费按成功请求算，每千次成功请求 0.75 美元，搜索和抓取分开计。
先搜再抓的标准流程
第一步，调用搜索接口，查询字段 1 到 128 个字符，支持 site、减号 site、引号短语、语言和日期等操作符；查询写短关键词，把用户的完整问题放在 ori_question 字段里，同样不超过 128 个字符。第二步，从返回的结果数组里挑质量分高的：rerank_score 满分 3 分，1.5 分以上算高质量，authority 满分 4 分，3 分以上算高权威。第三步，对挑中的页面调用抓取接口，传入单个网址，拿到标题和 Markdown 正文；也可以在搜索时把 need_content 打开，直接拿到内容，省一次调用。抓取受目标网站的访问策略限制，取不到页面时先换来源，不要反复重试同一个地址。
限流与错误处理
每个账号搜索和抓取各限 5 QPS，超出会返回 429。遇到 408、429 或 5xx 错误，等一会儿再重试；遇到 402 先充值；其他 4xx 错误要先改请求，不要原样重试。无结果或失败的请求不计费，只有成功返回结果的请求才收费。从 2026 年 11 月 1 日北京时间零点起，经 DeepSeek Harness、Claude Code 或 Codex 发起的服务端工具调用也开始按次计费，之前免费的那段已经结束，调用量大的流程要先在控制台看用量。
什么时候不适合用这对接口
只需要模型回答、不需要联网事实的时候，直接调聊天模型更便宜。只要一个固定页面的内容、且页面结构稳定时，自己下载转 Markdown 也行，不必为每次抓取付费。这对接口真正省事的地方，是智能体和检索应用需要“先找、再读、再引用”的完整链路。
