跳转到主要内容
POST
网页搜索:deepseek-search
右侧 Playground 可直接调试:在 Authorization 填 Bearer sk-your-api-key(default 或 svip 分组的令牌), 默认示例已填好,点击发送即可看到搜索结果。每次成功调用扣费一次。 localization 要填用户的 IP 地址(如 8.8.8.8),填 zh-CN 这类语言代码会返回 400。
定价、实测数据与必须知道的几件事见 概览。

参数说明速查

请求体不需要 model 字段;未识别的字段会被忽略。

响应要点

  • 给模型用 summary,给人看用 snippet;全文要么开 need_content,要么挑几条用 Fetch 抓
  • rerank_score ≥ 1.5、authority ≥ 3 可视为高质量结果,适合做过滤阈值
  • count=50 时响应体约 180KB,开 need_content 会再大一倍以上,注意客户端超时设置

错误码对照

错误体的 type 统一为 shell_api_error,请以 HTTP 状态码判断错误种类。

授权

Authorization
string
header
必填

在请求头中添加 Authorization: Bearer YOUR_API_KEY

请求体

application/json
query
string
必填

搜索词,1–128 个字符,不能全是空白。支持 site: / lang: / after: 等搜索语法

示例:

"DeepSeek V4 发布"

count
integer
默认值:10

返回条数,1–50。不影响价格

必填范围: 1 <= x <= 50
示例:

5

need_content
boolean
默认值:false

是否返回网页正文。为 false 时 content 恒为空字符串

ori_question
string

触发这次搜索的用户原始问题,1–128 个字符

localization
string

用户的 IP 地址,用于优先返回本地化结果。不是语言代码,传 ja-JP 会返回 400

示例:

"8.8.8.8"

响应

搜索成功(计费一次)

results
object[]