搜索 API 和获取 API 为代理和 RAG 应用提供访问实时网页内容的功能：搜索 API 查找网页并返回结构化结果。它由 DeepSeek 的内部搜索引擎提供支持。获取 API 检索单个网页并将其内容以 Markdown 格式返回。两者都是原始 JSON API。它们使用与 DeepSeek API 相同的承载身份验证。基本 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 内容类型在请求头中：头部 必需 值 授权 是 Bearer <DeepSeek API 密钥> 内容类型 是 application/json 搜索 API 请求 curl https://api.deepseek.com/v1/tools/search \ -H "Authorization: Bearer <DeepSeek API 密钥>" \ -H "Content-Type: application/json" \ -d '{ "query": "DeepSeek V4 发行", "count": 5, "need_content": true }' import requests response = requests . post ( "https://api.deepseek.com/v1/tools/search" , headers = { "Authorization" : "Bearer <DeepSeek API 密钥>" , } , json = { "query" : "DeepSeek V4 发行" , "count" : 5 , "need_content" : True , } , ) response . raise_for_status ( ) for result in response . json ( ) [ "results" ] : print ( result [ "title" ] , result [ "url" ] ) print ( result [ "summary" ] ) 请求字段：字段 类型 必需 默认 描述 query 字符串 是 - 搜索查询必须包含 1 到 128 个 Unicode 字符，不能全为空格，并支持下面列出的查询运算符。 count 整数 否 10 返回的结果数量在 1 到 50 之间。 ori_question 字符串 否 - 触发搜索的用户原始问题，长度在 1 到 128 个字符之间，以提高查询理解，null 被视为未提供。 localization 字符串 否 "" 用于本地化搜索结果的可选 IP 地址。 need_content 布尔 否 false 是否返回页面内容，如果为 false，则总是返回空字符串。请求体中的未知字段将被忽略。查询运算符 查询将保持其搜索语法不变。以下示例将运算符与搜索术语结合；您可以在一个查询中组合多个运算符。运算符 示例 描述 site: DeepSeek site:github.com 限制结果为指定站点，多个站点时，将 site: 条款用空格分隔并用 OR 连接，例如 DeepSeek site:github.com OR site:huggingface.co 。 -site: DeepSeek -site:example.com 排除指定站点，多个站点用空格分隔。 - DeepSeek -advertisement 排除包含该术语的页面，多个术语用空格分隔。 -"..." DeepSeek -"release notes" 排除包含确切短语的页面，该短语可以包含空格，多个短语用空格分隔。 "..." DeepSeek "确切短语" 匹配精确短语，多个短语用空格分隔。 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 } ] } 结果中的每个项目包含：字段 类型 描述 rerank_score 数字 从 0 到 3 的相关性评分，结合相关性、权威性和时效性等信号，评分在 1.5 或以上被视为高质量结果。 title 字符串 结果的标题。 url 字符串 结果的 URL。 snippet 字符串 与查询相关的简短摘要，通常为 100 到 200 个字符，用于在 UI 中显示。 summary 字符串 与查询相关的长摘要，通常为 600 到 800 个字符，供模型阅读。 content 字符串 页面内容，当 need_content 为 false 或内容不可用时为空。 site_name 字符串或null 网站名称，若不可用则为 null。 site_icon 字符串或null 网站图标的 URL，若不可用则为 null。 date 字符串或null 以 UTC 表示的发布时间。