DeepSeek search and fetch – $0.75 per 1000 successful requests

搜索与获取 | DeepSeek API 文档

本页内容

搜索与获取

搜索 API 和获取 API 为代理和 RAG 应用程序提供实时网页内容访问：

• 搜索 API 根据查询查找网页并返回结构化结果。它由 DeepSeek 自研搜索引擎提供支持。

• 获取 API 提取单个网页并以 Markdown 格式返回其内容。

两者均为原始 JSON API，使用与 DeepSeek API 相同的 bearer 认证方式。

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

API | 接口 --- | --- 搜索 |

POST https://api.deepseek.com/v1/tools/search

获取 |

POST https://api.deepseek.com/v1/tools/fetch

请参阅[搜索 API 参考](#)和[获取 API 参考](#)查看完整的请求和响应模式。

认证

在请求头中发送 API 密钥和 JSON 内容类型：

| 请求头 | 必填 | 值 | |---|---|---| | Authorization | 是 | Bearer <DeepSeek API Key> | | Content-Type | | application/json |

搜索 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 | string | - | 搜索查询必须包含 1 到 128 个 Unicode 字符，不能全为空白字符，支持下方列出的查询操作符 | | count | integer | 10 | 返回结果数量（1-50） | | ori_question | string | null | 触发搜索的原始用户问题（1-128 字符），用于提升查询理解，null 表示未提供 | | localization | string | "" | 用于本地化搜索结果的可选 IP 地址 | | need_content | boolean | false | 是否返回页面内容（当为 false 时 content 始终为空字符串） |

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

查询操作符

查询会完整保留其搜索语法。以下示例展示了操作符与搜索词的组合方式，可在单个查询中组合多个操作符。

| 操作符 | 示例 | 说明 | |---|---|---| | site: | DeepSeek site:github.com | 限制结果到指定站点，使用空格分隔多个站点并用 OR 连接，例如 DeepSeek site:github.com OR site:huggingface.co | | -site: | DeepSeek -site:example.com | 排除指定站点，用空格分隔多个站点 | | - | DeepSeek -advertisement | 排除包含指定术语的页面，用空格分隔多个术语 | | -"..." | DeepSeek -"release notes" | 排除包含精确短语的页面（可含空格），用空格分隔多个短语 | | "..." | DeepSeek "exact phrase" | 匹配精确短语，用空格分隔多个短语 | | lang: | DeepSeek lang:zh,en | 限定语言，支持多语言用逗号分隔

限制结果为给定的语言代码，多个代码用逗号分隔，例如

lang:zh,en

after:

DeepSeek after:2025

或

DeepSeek after:2025-01-01

限制结果为指定日期之后发布的页面。

before:

DeepSeek before:2026

DeepSeek before:2026-06-01

限制结果为指定日期之前发布的页面。

例如：

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

响应 ​

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

{
"results": [
{
"rerank_score": 2.4,
"title": "DeepSeek V4 模型发布",
"url": "https://example.com/deepseek-v4",
"snippet": "DeepSeek V4 现已发布，支持工具调用和长上下文。",
"summary": "DeepSeek 已发布 V4 模型。此次发布增加了改进的工具调用和长上下文支持，适用于代理工作流程。",
"content": "DeepSeek V4 现已正式发布...",
"site_name": "示例新闻",
"site_icon": "https://example.com/favicon.ico",
"date": "2026-06-01T00:00:00+00:00",
"authority": 3
}
]
}

results 中的每个项目包含：

rerank_score

数字

一个 0 到 3 的相关性评分，结合了相关性、权威性和新鲜度等因素，评分 1.5 或以上视为高质量结果。

title

结果的标题。

url

结果的 URL。

snippet

与查询相关的简短摘要，通常为 100 到 200 个字符，用于在 UI 中显示。

summary

与查询相关的长摘要，通常为 600 到 800 个字符，用于模型阅读。

页面内容，当

是

或内容不可用时为空。

site_name

字符串或 null

网站名称，或

不可用时。

site_icon

网站图标 URL，或

date

以 RFC 3339 格式表示的 UTC 发布时间，或

未知时。

authority

页面的权威等级，0 到 4 (

-1

表示未知)，3 或以上表示高度权威的来源。

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

要获取的页面 URL，必须最多 8192 个字符，必须是带有主机的 HTTP 或 HTTPS URL，且不能包含用户名或密码。

{
"title": "示例文章",
"content": "# 示例文章\n\n文章内容。"
}

页面标题，标题不可用时为空。

获取的页面内容作为 Markdown 文本。

获取操作受目标网站的可用性和访问策略限制。

错误 ​

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

{
"error": {
"message": "'count' 必须在 1 和 50 之间",
"type": "invalid_request_error",
"param": null,
"code": "invalid_request_error"
}
}

HTTP 状态

400

请求头或请求体无效，包括格式错误的 JSON 或无效的字段值。

401

API 密钥缺失或无效。

402

账户余额不足。

403

Fetch 请求被安全策略拒绝。

404

Fetch 无法获取可用页面内容，例如由于 URL 不可用、URL 被网站策略阻止、目标站点错误、不支持的内容类型，或没有可提取 Markdown 内容的页面。

408

读取请求体超时。

413

请求体过大。

429

Search 或 Fetch 的 QPS 限制已超出。

500

发生内部服务器错误。

504

下游请求超时。

Search 和 Fetch 为只读接口。对于 HTTP 408、429 或 5xx 错误，请等待后重试。对于 HTTP 402 错误，请先为账户充值后再重试。其他 4xx 错误在未修改请求的情况下请勿重试。

计费

Search 和 Fetch 按成功请求计费，而非按令牌数或返回结果数量计费：

单位

价格

每 1,000 次成功请求

$0.75

只有在返回 HTTP 200 且产生结果时（Search 必须返回非空结果数组，Fetch 必须返回页面内容）请求才会产生费用。失败请求、空搜索结果和超时不会计费。count 参数仅控制返回结果数量，不影响单次请求费用。

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

速率限制

每个账户的 Search 和 Fetch 独立限流，两者流量互不占用配额：

每秒请求数限制

5

QPS（每秒请求数）限制在账户层级计算，无论使用哪个 API 密钥，且与模型并发限制相互独立。超出账户层级 QPS 限制的请求将返回 HTTP 429。除账户层级限制外，Fetch 还受每域名 QPS 限制，超出该限制的请求也将返回 HTTP 429。