DeepSeek web search

POST/v1/tools/search

Authorization

bearerAuth

AuthorizationBearer <token>

Use an API Key issued by the platform.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Unknown fields are ignored upstream and do not select a model or group.

query*string

Search query, counted in Unicode characters; cannot consist entirely of whitespace. Supports site, language, date, and keyword search syntax.

Match\S

Length1 <= length <= 128

count?integer

Number of results to return; does not affect the price per request.

Range1 <= value <= 50

Default10

need_content?boolean

Whether to return page content. When false, each content is an empty string; when true, unavailable content may still be empty.

Defaultfalse

ori_question?string|null

The original question that triggered the search, helping clarify intent; null is treated as omitted.

Length1 <= length <= 128

localization?string

IP address used to prioritize localized search results.

Default""

Response Body

`application/json`

curl -X POST "https://example.com/v1/tools/search" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "DeepSeek site:api-docs.deepseek.com",
    "count": 5,
    "need_content": false
  }'

One result is shown; longer text has been shortened.

{
  "results": [
    {
      "title": "DeepSeek-V4 预览版：迈入百万上下文普惠时代",
      "url": "https://api-docs.deepseek.com/zh-cn/news/news260424/#1",
      "snippet": "DeepSeek-V4 预览版的发布说明。",
      "summary": "该页面介绍 DeepSeek-V4 预览版的上线信息及主要能力。",
      "content": "",
      "rerank_score": 2.070382833480835,
      "site_name": "DeepSeek",
      "site_icon": "https://cdn.deepseek.com/site-icons/deepseek.com",
      "date": "2026-04-23T16:00:00+00:00",
      "authority": 3
    }
  ]
}

Search syntax

Combine keywords with these operators in query; no additional request fields are needed.

Operator	Usage
`site:`	`DeepSeek site:github.com` limits results to a site; join multiple sites with `OR`
`-site:`	`DeepSeek -site:example.com` excludes a site
`-`, `-"..."`	`DeepSeek -ads -"release notes"` excludes keywords or phrases
`"..."`	`DeepSeek "exact phrase"` matches a complete phrase
`lang:`	`DeepSeek lang:zh,en` limits languages; separate multiple languages with commas
`after:`, `before:`	`DeepSeek after:2026-01-01 before:2026-11-01` limits publication dates; a year alone is also accepted

An HTTP 200 response with nonempty results is billed as one successful request. Empty results, failures, and timeouts are not billed. count and need_content do not increase the number of billable requests per call. No additional usage is returned.

To read the full content of a selected page, use web fetch. For combined calls and model search examples, see the guide.

DeepSeek Search official documentationSee the upstream API definition and latest field changes.

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

Search syntax

Billing and usage

`application/json`

`application/json`

`application/json`