L’API de recherche et l’API de récupération de DeepSeek forment une paire : l’API de recherche trouve des pages web pour un mot-clé et renvoie titres, liens, résumés, dates et scores de qualité ; l’API de récupération récupère une seule page web et la convertit en Markdown pour le modèle ou le flux de recherche documentaire. Les deux interfaces utilisent la même clé que l’API de discussion de DeepSeek et fonctionnent avec des requêtes JSON brutes, sans passer par le modèle de discussion. La facturation se fait par requête réussie : 0,75 dollar pour 1 000 requêtes réussies, recherche et récupération comptées séparément.
Le flux standard : chercher d’abord, puis récupérer
Premièrement, appelez le point de terminaison de recherche : le champ de requête contient de 1 à 128 caractères et prend en charge des opérateurs comme site:, -site:, les expressions entre guillemets, la langue et la date ; écrivez des mots-clés courts dans la requête et placez la question complète de l’utilisateur dans le champ ori_question, également limité à 128 caractères. Deuxièmement, choisissez les résultats de qualité dans le tableau renvoyé : rerank_score culmine à 3, 1,5 ou plus comptant comme haute qualité, et authority culmine à 4, 3 ou plus comptant comme haute autorité. Troisièmement, appelez le point de terminaison de récupération pour les pages choisies, transmettez une seule URL et obtenez le titre et le corps en Markdown ; vous pouvez aussi activer need_content dans la recherche pour obtenir le contenu directement, ce qui économise un appel. La récupération est soumise aux règles d’accès du site cible — si une page ne peut pas être récupérée, changez d’abord de source plutôt que de réessayer la même adresse à répétition.
Limites de débit et gestion des erreurs
Chaque compte est plafonné à 5 requêtes par seconde pour la recherche et 5 pour la récupération, et tout dépassement renvoie 429. En cas d’erreur 408, 429 ou 5xx, attendez un peu puis réessayez ; en cas de 402, rechargez d’abord ; les autres erreurs 4xx exigent de modifier la requête avant tout, pas de la relancer telle quelle. Les requêtes sans résultat ou en échec ne sont pas facturées ; seules les requêtes qui renvoient des résultats avec succès sont facturées. Depuis le 1er novembre 2026 à 00h00, heure de Pékin, les appels d’outils côté serveur effectués via DeepSeek Harness, Claude Code ou Codex sont également facturés par appel — la période gratuite antérieure est terminée, et les flux à fort volume d’appels doivent d’abord vérifier l’utilisation dans la console.
Quand cette paire d’API ne convient pas
Quand seule une réponse du modèle est nécessaire, sans faits web en direct, appeler directement le modèle de discussion est moins cher. Quand seul le contenu d’une page fixe est nécessaire et que la structure de la page est stable, télécharger la page et la convertir soi-même en Markdown fonctionne aussi, sans payer chaque récupération. Cette paire d’API fait vraiment gagner du temps quand les agents et les applications de recherche documentaire ont besoin de la chaîne complète « trouver d’abord, puis lire, puis citer ».
