En bref. Utiliser search_domain_filter pour sélectionner les sources de recherche autorisées, puis vérifier les URL renvoyées et les affirmations de la réponse à l’aide des pages autorisées.
Définition : Au 17 octobre 2026,
search_domain_filterde Perplexity est un paramètre d’API qui limite les résultats de recherche web aux domaines autorisés ou exclut certains domaines. Une liste d’autorisation (allowlist) sélectionne les sources permises pour une requête ; une application qui exige des réponses étayées exclusivement par ces sources devrait aussi valider les affirmations de la réponse.
Points clés
- Le guide Search Domain Filter de Perplexity indique une limite de 20 entrées et des modes distincts pour la liste d’autorisation et la liste d’exclusion (denylist).
- La présentation de la migration de Perplexity précise que la prise en charge de Sonar Chat Completions a pris fin le 27 septembre 2026 ; les requêtes synchrones et en flux continu (streaming) continuent de fonctionner grâce à leur reformulation progressive en requêtes à l’Agent API.
- Les instructions de migration déplacent les filtres de recherche de Sonar, placés au premier niveau, vers la configuration de l’outil
web_searchde l’Agent API. - La référence Web Search identifie chaque source renvoyée par ses champs
ideturl.
Comment configurer la restriction par domaine ?
Les instructions de migration de Perplexity présentent search_domain_filter comme un paramètre de premier niveau dans une requête Sonar. Ce fragment JSON illustre une liste d’autorisation contenant un domaine racine utilisé dans les exemples de Perplexity :
{
"search_domain_filter": ["nature.com"]
}
Dans une intégration existante pour un site web, la valeur du domaine est remplacée par le domaine du site. Le paramètre figure dans la requête API envoyée par l’application. Le guide Search Domain Filter présente aussi ce paramètre dans des requêtes à la Search API.
Pour l’Agent API, ce même paramètre se place dans filters, au sein de l’outil web_search. Le fragment de corps de requête suivant reprend la structure des instructions de migration :
{
"preset": "fast",
"input": "Latest renewable energy policy updates",
"tools": [{
"type": "web_search",
"filters": {
"search_domain_filter": ["iea.org", "energy.gov"]
}
}]
}
La présentation de la migration de Perplexity recommande de migrer les usages existants de Sonar vers l’Agent API.
Quelles sont les limites du filtre ?
Le guide du filtrage par domaine de Perplexity définit la liste d’autorisation comme une sélection limitée aux domaines répertoriés. Une liste d’exclusion écarte les entrées précédées de -. Les deux modes ne peuvent pas se combiner dans une même requête.
Le guide demande des domaines sans protocole et recommande d’éviter le préfixe www. Un domaine racine inclut ses sous-domaines. Pour cibler une section plus restreinte, le guide accepte un domaine suivi d’un chemin : nature.com/articles correspond à cette section et à ses sous-chemins, y compris sur les sous-domaines.
Restreindre les sources peut réduire le nombre de résultats ou ne renvoyer aucun résultat. Combiner le filtrage par domaine avec des filtres de date ou de langue peut encore réduire les résultats disponibles. L’application doit donc gérer une réponse de recherche vide.
Comment vérifier la réponse renvoyée ?
La référence Web Search de Perplexity décrit des entrées search_results contenant une url canonique, un title et un snippet composé de texte extrait pendant la recherche. Elle désigne les champs id et url comme les données de référence pour les citations.
Pour une application soumise à des règles strictes sur les sources, la validation devrait comparer les URL renvoyées au périmètre des domaines autorisés. Un contrôle distinct du contenu devrait comparer les affirmations factuelles aux pages autorisées. Le guide de migration de Perplexity fournit une instruction qui demande au modèle de vérifier chaque affirmation à l’aide des résultats cités et de supprimer les affirmations non étayées. La sélection des domaines et la vérification des affirmations constituent des contrôles distincts.
Termes associés
Questions fréquentes
Puis-je inclure plusieurs domaines ?
Oui. Le guide du filtrage par domaine autorise jusqu’à 20 entrées par requête. Vous devez choisir le mode liste d’autorisation ou le mode liste d’exclusion.
Inscrire mon domaine suffit-il pour que chaque affirmation de la réponse en provienne ?
Vous devriez vérifier les affirmations à l’aide des sources renvoyées. Le guide de migration de Perplexity fournit une instruction explicite de vérification des affirmations à cette fin.
Où placer le filtre après la migration ?
La référence Web Search de l’Agent API place search_domain_filter dans tools[].filters pour un outil dont le champ type vaut web_search.
Sources
- Perplexity, « Search Domain Filter », sans date
- Perplexity, « Migrate from Sonar to the Agent API », sans date
- Perplexity, « How to migrate from Sonar », sans date
- Perplexity, « Web Search », sans date
Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO