BlackHalo logo
Published on

DeepSeek推出搜索与抓取API:每千次成功请求仅需0.75美元

Authors
  • Name
    fagnerbrack
    api-docs.deepseek.com
DeepSeek search and fetch – $0.75 per 1000 successful requests 相关头图
头图来源: 来源页面

概述

DeepSeek API 全新推出搜索(Search)与抓取(Fetch)两项接口,为智能体和 RAG 应用提供实时网络内容访问能力。搜索 API 基于 DeepSeek 自研搜索引擎,能够对查询返回结构化结果;抓取 API 则可将单个网页内容转换为 Markdown 格式。两项接口均为原生 JSON API,使用与 DeepSeek API 相同的 Bearer 认证方式,基础地址为 https://api.deepseek.com。官方宣布,自 2026 年 11 月 1 日北京时间零时起,对每千次成功请求收费 0.75 美元;在此之前,通过 DeepSeek Harness、Claude Code 或 Codex 等工具产生的服务器端调用仍然免费。

接口端点与认证

搜索接口为 POST https://api.deepseek.com/v1/tools/search,抓取接口为 POST https://api.deepseek.com/v1/tools/fetch。请求时需要设置 Authorization 请求头,携带 Bearer <DeepSeek API Key>,同时设置 Content-Type 为 application/json。官方文档提供了 curl 和 Python requests 示例,展示了如何发起调用。请求体采用 JSON 格式,未知字段会被忽略。

搜索 API 详解

搜索 API 接受查询字符串和若干可选参数。查询字符串必填,长度为 1 到 128 个 Unicode 字符,不能全部为空白。count 参数控制返回结果数量,默认 10,范围 1 到 50。ori_question 参数可传入用户触发搜索时的原始问题,用于提升查询理解,最长为 128 字符。localization 参数接收一个 IP 地址,用于本地化搜索结果。need_content 参数指示是否返回页面正文内容,默认 false,此时 content 字段为空字符串。

响应为 HTTP 200,包含 results 数组。普通搜索无匹配时返回空数组。每个结果项包括 rerank_score(相关性评分,0 到 3,1.5 以上视为高质量)、title、url、snippet(100 到 200 字符的短摘要,适合界面展示)、summary(600 到 800 字符的长摘要,适合模型阅读)、content(当 need_content 为 true 时返回的页面正文)、site_name、site_icon、date(RFC 3339 格式的 UTC 时间)、authority(权威度分级,0 到 4,-1 为未知,3 及以上表示高权威来源)。

搜索查询支持多种操作符。site: 用于限定站点,多个站点用空格分隔并配合 OR 连接,例如 DeepSeek site:github.com OR site:huggingface.co。-site: 用于排除指定站点。- 前缀可排除包含指定词的页面;-"..." 排除包含精确短语的页面;"..." 匹配精确短语;lang: 限定语言代码,例如 lang:zh,en;after: 和 before: 限定发布时间范围,支持年份或日期格式。这些操作符可与普通搜索词组合,查询会原样转发给搜索引擎。

抓取 API 详解

抓取 API 接受 url 参数,必填,最长 8192 字符,必须是带主机的 HTTP/HTTPS 地址,且不能包含用户名或密码。成功时返回页面标题和正文内容,正文以 Markdown 文本形式提供。抓取行为受目标网站的可访问性和访问策略限制。请求失败可能包括:URL 不可用、被站点策略阻止、目标站点返回错误、内容类型不支持,或页面无法提取 Markdown 内容。

错误处理

错误遵循 OpenAI 兼容格式,param 字段始终为 null。常见的 HTTP 状态码有:400 请求头或请求体无效(包括 JSON 格式错误或字段值非法);401 API 密钥缺失或无效;402 账户余额不足;403 抓取请求被安全策略拒绝;404 抓取无法获取可用的页面内容;408 读取请求体超时;413 请求体过大;429 超过搜索或抓取的 QPS 限制;500 服务器内部错误;504 下游请求超时。搜索和抓取为只读操作。对于 408、429 或 5xx 错误,应等待后重试;402 错误需充值后重试;其他 4xx 错误需修改请求后再试。

计费与限流

两项接口均按成功请求计费,而非按 token 或返回结果数量。每成功 1000 次请求收费 0.75 美元。一个请求仅在返回 HTTP 200 且产生结果时才计费:搜索必须返回非空 results 数组,抓取必须返回页面内容。失败请求、空搜索结果和超时均不收费。count 参数只是控制返回结果数,不影响单次请求价格。在 2026 年 11 月 1 日之前,通过 DeepSeek Harness、Claude Code 或 Codex 等工具进行的服务器端工具调用虽会命中这两个接口,但暂免计费。

限流方面,每个账户的搜索和抓取独立限制,相互不消耗配额。搜索的 QPS 上限为 100,抓取为 25。QPS 限制按账户级别计算,无论使用哪个 API key,这些限制与模型并发限制是分开的。超过账户级 QPS 会返回 HTTP 429。此外,抓取接口还受每个域名的 QPS 限制,超过该限制同样返回 429。

总结

DeepSeek 搜索与抓取 API 以极低的价格和灵活的参数设计,为智能体和 RAG 应用提供了实时联网能力。结构化结果、丰富的内容字段和详细的错误信息使其易于集成。计费模式透明,限流策略清晰,对开发者非常友好。当前免费阶段截止到 2026 年 10 月 31 日,有需要的团队可提前接入测试。

原标题:DeepSeek search and fetch – $0.75 per 1000 successful requests。 HN 原始发布时间:2026年10月18日星期日。当前记录为 598 分、280 条评论。

阅读原文 · 查看 HN 讨论