DeepSeek Search API: веб-поиск и Fetch для приложений

Если вашему приложению нужны свежие данные из интернета, не обязательно просить языковую модель «что-нибудь найти». У DeepSeek есть отдельные Search API и Fetch API, которые можно использовать как управляемые инструменты.

Чем Search отличается от Fetch

• Search ищет страницы по запросу и возвращает структурированный список результатов.
• Fetch получает содержимое конкретной страницы и возвращает его в удобном для обработки виде.

Вместе они подходят для RAG, исследовательских агентов, проверки ссылок и приложений, которым нужна актуальная информация.

Минимальный Search-запрос

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

Полезные ограничения поиска

Запрос поддерживает операторы, которые помогают сразу сузить выдачу:

• site: — искать на конкретном домене;
• -site: — исключить домен;
• кавычки — искать точную фразу;
• lang: — ограничить язык;
• after: и before: — ограничить даты.

Зачем нужен Fetch

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

Как строить надёжную цепочку

1. Сформулировать конкретный поисковый запрос.
2. Получить 5–10 результатов.
3. Отфильтровать домены и даты.
4. Fetch только нужные страницы.
5. Передать модели извлечённые материалы.
6. Сохранить URL рядом с выводом, чтобы пользователь мог проверить источник.

Search API или встроенный web_search

Search/Fetch удобны, когда вы хотите сами контролировать процесс поиска. В Responses API у модели Pro также есть серверный web_search. Это проще для агента, но даёт приложению меньше контроля над каждой стадией.

Сколько стоит Search и Fetch

Оба инструмента оплачиваются отдельно от токенов модели: Search — $0.75 за 1000 успешных запросов, Fetch — $0.75 за 1000 успешных запросов. Пустой результат поиска, ошибка или таймаут не считаются успешным биллинговым запросом.

Если после Search вы передаёте найденный контент языковой модели, токены самой модели оплачиваются отдельно. Общая логика расходов — в статье про цены DeepSeek API.

Типичные ошибки

• делать Fetch десятков страниц без предварительного отбора;
• не ограничивать дату для новостей;
• передавать модели результаты без URL;
• смешивать данные разных дат как одновременные;
• считать поисковый сниппет полным содержимым страницы.

Для обычного пользователя

Если вы не пишете приложение, отдельный API не нужен. Используйте веб-поиск в интерфейсе DeepSeek. Инструкция для обычного чата — «Поиск в DeepSeek».

Если у вас ещё нет доступа к API, начните с создания DeepSeek API key и первого запроса, а затем подключайте платный поиск.

Цепочка Search → Fetch на двух запросах

Этот воспроизводимый пример показывает форму запросов из документации; реальный API-ответ зависит от индекса и текущего содержимого сайтов.

curl https://api.deepseek.com/v1/tools/search \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"DeepSeek V4.1 site:api-docs.deepseek.com","count":5,"need_content":false}'

В JSON ожидайте массив results; у результатов есть title, url, snippet, summary и иногда дату. Выберите подходящий URL из фактического результата, а не из выдуманного примера, и передайте его в Fetch:

curl https://api.deepseek.com/v1/tools/fetch \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://api-docs.deepseek.com/updates/"}'

Fetch возвращает title и content в Markdown, если страницу удалось прочитать. Для RAG сохраняйте рядом с извлечённым фрагментом исходный URL и время получения.

Ограничения и контроль расходов

• Search и Fetch имеют независимые лимиты по 5 запросов/с на аккаунт; при превышении ожидайте HTTP 429.
• За Search и Fetch берётся по $0.75 за 1000 успешных запросов; пустой Search и неуспешный Fetch по правилам API не тарифицируются.
• Платные вызовы в прямом API не путайте с временными льготами для интеграций: для серверных вызовов через Harness, Claude Code и Codex установлен отдельный старт тарификации 1 ноября 2026 года по пекинскому времени.
• Не передавайте в поисковые запросы пароли, персональные данные или секреты приложения.

Официальная документация Search & Fetch, обновлено 17 октября 2026 года.

Контрольный результат: какая цепочка считается успешной

Проверяйте не «красивый ответ», а наблюдаемые условия выполнения. Для Search успешным считается HTTP 200 с JSON-массивом results (даже если он пуст). Для Fetch — HTTP 200 с полями title и content; содержимое должно относиться к URL, реально выбранному из предыдущего поиска. Измеряйте задержку, количество успешных вызовов и стоимость отдельно от токенов модели.

В официальной спецификации приведён образец ответа, но конкретных результатов Search/Fetch из платного аккаунта VirtRe в этой статье пока нет. Для воспроизведения понадобятся действующий API-ключ и баланс.

Коротко

Search ищет, Fetch читает. Для управляемого RAG и агентов это удобнее, чем отдавать весь интернет на усмотрение модели. Начните с маленькой цепочки Search → отбор → Fetch → ответ и только потом усложняйте её.