Recherche web DeepSeek

Obtenez des liens, des résumés et du contenu de page facultatif à partir d'une requête.

POST/v1/tools/search

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez une API Key émise par la plateforme.

Emplacement: header

Corps de requête

application/json

Définitions TypeScript

Utilisez le type request body en TypeScript.

Les champs inconnus sont ignorés en amont et ne sélectionnent ni modèle ni groupe.

query*string

Requête comptée en caractères Unicode ; elle ne peut pas être composée uniquement d'espaces. Prend en charge la recherche par site, langue, date et mot-clé.

Motif\S

Longueur1 <= length <= 128

count?integer

Nombre de résultats à renvoyer ; sans effet sur le prix par requête.

Plage1 <= value <= 50

Valeur par défaut10

need_content?boolean

Indique s'il faut renvoyer le contenu des pages. Si false, chaque content est une chaîne vide ; si true, un contenu indisponible peut rester vide.

Valeur par défautfalse

ori_question?string|null

Question d'origine ayant déclenché la recherche, pour préciser l'intention ; null est traité comme une absence de valeur.

Longueur1 <= length <= 128

localization?string

Adresse IP utilisée pour privilégier les résultats localisés.

Valeur par défaut""

Corps de réponse

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

Un seul résultat est affiché ; les textes longs ont été abrégés.

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

Syntaxe de recherche

Combinez mots-clés et opérateurs dans query ; aucun champ supplémentaire n'est nécessaire.

Opérateur	Utilisation
`site:`	`DeepSeek site:github.com` limite la recherche à un site ; reliez plusieurs sites avec `OR`
`-site:`	`DeepSeek -site:example.com` exclut un site
`-`, `-"..."`	`DeepSeek -ads -"release notes"` exclut des mots-clés ou expressions
`"..."`	`DeepSeek "exact phrase"` recherche l'expression complète
`lang:`	`DeepSeek lang:zh,en` limite les langues ; séparez-les par des virgules
`after:`, `before:`	`DeepSeek after:2026-01-01 before:2026-11-01` limite les dates de publication ; une année seule est aussi acceptée

Une réponse HTTP 200 avec results non vide est facturée comme une requête réussie. Les résultats vides, échecs et délais dépassés ne sont pas facturés. count et need_content n'augmentent pas le nombre de requêtes facturées par appel. Aucun usage supplémentaire n'est renvoyé.

Pour lire le contenu complet d'une page sélectionnée, utilisez la récupération web. Consultez le guide pour combiner les appels et utiliser la recherche avec un modèle.

Documentation officielle DeepSeek SearchConsultez la définition de l'API en amont et les dernières modifications de champs.

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

Syntaxe de recherche

Facturation et utilisation

`application/json`

`application/json`

`application/json`