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：

请参阅 Search API 参考 和 Fetch API 参考 以获取完整的请求和响应 schema。

身份验证

在请求头中发送你的 API 密钥和 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"])

请求字段：

响应

{
  "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 起开始。

速率限制

对于每个账户，Search 和 Fetch 的限制相互独立，一者的流量不消耗另一者的配额：

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