DeepSeek 上线 Search 与 Fetch API，每千次成功请求 0.75 美元

Search API 和 Fetch API 让智能体和 RAG 应用能够访问实时网络内容：

• Search API 针对查询查找网页并返回结构化结果。它由 DeepSeek 自研搜索引擎提供支持。
• Fetch API 获取单个网页并以 Markdown 返回其内容。

两者都是原始 JSON API。它们使用与 DeepSeek API 相同的 bearer 认证。

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

完整的请求和响应 schema 请参阅 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 requests

response = 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 requests

response = 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"])

请求字段：

Response​

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

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

Errors​

错误遵循 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 错误在未修改请求的情况下请勿重试。

Billing​

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

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

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

Rate Limits​

对于每个账户，Search 和 Fetch 分别独立限流，访问其中一个不会消耗另一个的配额：

QPS（每秒请求数）限制按账户级别计算，与使用哪个 API key 无关，并且与模型并发限制相互独立。超过账户级 QPS 限制的请求会收到 HTTP 429。除账户级限制外，Fetch 还受每个域名的 QPS 限制约束，超过该限制的请求同样会收到 HTTP 429。