Веб-поиск DeepSeek

Поиск ссылок, кратких описаний и необязательного содержимого страниц по запросу.

POST/v1/tools/search

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте API Key, выданный платформой.

Расположение: header

Тело запроса

application/json

Определения типов TypeScript

Используйте тип request body в TypeScript.

Неизвестные поля игнорируются вышестоящим сервисом и не выбирают модель или группу.

query*string

Поисковый запрос измеряется в символах Unicode и не может состоять только из пробелов. Поддерживается поиск по сайту, языку, дате и ключевым словам.

Шаблон\S

Длина1 <= length <= 128

count?integer

Число возвращаемых результатов; не влияет на стоимость одного запроса.

Диапазон1 <= value <= 50

По умолчанию10

need_content?boolean

Возвращать ли содержимое страниц. При false каждое content — пустая строка; при true недоступное содержимое также может быть пустым.

По умолчаниюfalse

ori_question?string|null

Исходный вопрос, вызвавший поиск, помогает уточнить намерение; null считается отсутствием значения.

Длина1 <= length <= 128

localization?string

IP-адрес для приоритетной выдачи локализованных результатов.

По умолчанию""

Тело ответа

`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
  }'

Показан один результат; длинные тексты сокращены.

{
  "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
    }
  ]
}

Синтаксис поиска

Сочетайте ключевые слова с операторами в query; дополнительные поля запроса не нужны.

Оператор	Использование
`site:`	`DeepSeek site:github.com` ограничивает поиск сайтом; соединяйте несколько сайтов через `OR`
`-site:`	`DeepSeek -site:example.com` исключает сайт
`-`, `-"..."`	`DeepSeek -ads -"release notes"` исключает слова или фразы
`"..."`	`DeepSeek "exact phrase"` ищет полную фразу
`lang:`	`DeepSeek lang:zh,en` ограничивает языки; несколько языков разделяются запятыми
`after:`, `before:`	`DeepSeek after:2026-01-01 before:2026-11-01` ограничивает дату публикации; можно указать только год

HTTP 200 с непустым results оплачивается как один успешный запрос. Пустые результаты, ошибки и тайм-ауты не оплачиваются. count и need_content не увеличивают число оплачиваемых запросов за вызов. Дополнительное поле usage не возвращается.

Для чтения полного содержимого выбранной страницы используйте получение страницы. Примеры совместных вызовов и поиска через модель приведены в руководстве.

Официальная документация DeepSeek SearchОпределение API вышестоящего сервиса и последние изменения полей.

Аутентификация

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

Синтаксис поиска

Оплата и использование

`application/json`

`application/json`

`application/json`