Перейти к основному содержанию
POST
Web search: deepseek-search
Попробуйте в Playground справа: укажите Bearer sk-your-api-key (ключ в группе default или svip) в Authorization. Пример по умолчанию уже заполнен; нажмите «Отправить», чтобы увидеть результат. Каждый успешный вызов тарифицируется один раз. localization принимает IP-адрес пользователя (например, 8.8.8.8); код локали, такой как en-US, возвращает ошибку 400.
Тарифы, тестовые данные и важная информация приведены в разделе Обзор.

Справочник параметров

Тело запроса не требует наличия поля model; неизвестные поля игнорируются.

Ключевые особенности ответа

  • Передавайте summary моделям, а snippet показывайте людям. Для получения полного текста либо включите need_content, либо выберите несколько результатов и используйте Fetch
  • rerank_score ≥ 1.5 и authority ≥ 3 указывают на высококачественные результаты и отлично подходят в качестве пороговых значений для фильтрации
  • С count=50 размер ответа составляет около 180 КБ, а need_content увеличивает его более чем в два раза; настройте таймаут клиента соответствующим образом

Коды ошибок

Поле type в теле ошибки всегда имеет значение shell_api_error; выполняйте ветвление по коду статуса HTTP.

Авторизации

Authorization
string
header
обязательно

Add Authorization: Bearer YOUR_API_KEY to the request headers

Тело

application/json
query
string
обязательно

Search query, 1–128 characters, not all whitespace. Supports site: / lang: / after: and other operators

Пример:

"DeepSeek V4 release"

count
integer
по умолчанию:10

Number of results, 1–50. Does not affect the price

Требуемый диапазон: 1 <= x <= 50
Пример:

5

need_content
boolean
по умолчанию:false

Whether to return the page body. When false, content is always an empty string

ori_question
string

The user's original question that triggered this search, 1–128 characters

localization
string

The user's IP address, used to prioritize localized results. Not a locale code: passing ja-JP returns 400

Пример:

"8.8.8.8"

Ответ

Search succeeded (billed once)

results
object[]