跳轉到主要內容
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[]