本页内容

搜索 API（Search API）与抓取 API（Fetch API）为智能体和 RAG 应用提供访问实时网页内容的能力：

• Search API：针对查询检索网页，并返回结构化结果。其背后由 DeepSeek 自研的搜索引擎驱动。
• Fetch API：抓取单个网页，并以 Markdown 返回其内容。

两者都是纯 JSON API，使用与 DeepSeek API 相同的 Bearer 认证。

基础 URL 为 https://api.deepseek.com：

完整的请求与响应结构，请参阅 Search API 参考 和 Fetch API 参考。

---

认证

在请求头中发送你的 API key 和 JSON 内容类型：

---

Search API

请求

curl https://api.deepseek.com/v1/tools/search \  -H "Authorization: Bearer <DeepSeek API Key>" \  -H "Content-Type: application/json" \  -d '{    "query": "DeepSeek V4 release",    "count": 5,    "need_content": true  }'

import requestsresponse = requests.post(    "https://api.deepseek.com/v1/tools/search",    headers={        "Authorization": "Bearer <DeepSeek API Key>",    },    json={        "query": "DeepSeek V4 release",        "count": 5,        "need_content": True,    },)response.raise_for_status()for result in response.json()["results"]:    print(result["title"], result["url"])    print(result["summary"])

请求字段：

请求体中的未知字段会被忽略。

查询运算符

查询会连同其搜索语法原样转发。下面的示例将运算符与搜索词组合使用；你可以在一个查询中组合多个运算符。

例如：

{  "query": "DeepSeek site:github.com OR site:huggingface.co lang:en after:2025",  "count": 10}

响应

请求成功时返回 HTTP 200 和一个 results 数组。没有匹配结果的正常搜索会返回空数组。

{  "results": [    {      "rerank_score": 2.4,      "title": "DeepSeek V4 model released",      "url": "https://example.com/deepseek-v4",      "snippet": "DeepSeek V4 is now available, with tool calling and long-context support.",      "summary": "DeepSeek has released the V4 model. The release adds improved tool calling and long-context support for agent workflows.",      "content": "DeepSeek V4 is now generally available...",      "site_name": "Example News",      "site_icon": "https://example.com/favicon.ico",      "date": "2026-06-01T00:00:00+00:00",      "authority": 3    }  ]}

results 中的每一项包含：

---

Fetch API

请求

curl https://api.deepseek.com/v1/tools/fetch \  -H "Authorization: Bearer <DeepSeek API Key>" \  -H "Content-Type: application/json" \  -d '{    "url": "https://example.com/article"  }'

import requestsresponse = requests.post(    "https://api.deepseek.com/v1/tools/fetch",    headers={        "Authorization": "Bearer <DeepSeek API Key>",    },    json={"url": "https://example.com/article"},)response.raise_for_status()page = response.json()print(page["title"])print(page["content"])

请求字段：

响应

{  "title": "Example article",  "content": "# Example article\n\nArticle content."}

抓取受目标站点的可用性与访问策略约束。

---

错误

错误采用兼容 OpenAI 的格式。param 字段始终为 null。

{  "error": {    "message": "'count' must be between 1 and 50",    "type": "invalid_request_error",    "param": null,    "code": "invalid_request_error"  }}

Search 与 Fetch 均为只读操作。遇到 HTTP 408、429 或 5xx 错误时，请等待后重试。遇到 HTTP 402 错误时，请先充值账户再重试。对于其他 4xx 错误，在未修改请求前不要重试。

---

计费

Search 与 Fetch 按成功请求计费，而不是按 token 或返回结果数量计费：

只有返回 HTTP 200 且产生结果的请求才会计费（Search 必须返回非空的 results 数组，Fetch 必须返回页面内容）。失败的请求、空搜索结果和超时均不计费。count 只控制返回多少条结果，不影响按请求计费的价格。

注意：当你通过 DeepSeek Harness、Claude Code 或 Codex 使用 DeepSeek API 时，服务端工具调用已经会访问 Search 与 Fetch API。这些调用目前免费；按请求计费将于北京时间 2026 年 11 月 1 日 00:00 开始。