Context API extrait le contexte complet de n’importe quelle page web
Utilisez Perplexity Context API pour fournir aux agents IA du Markdown propre, des liens et des passages pertinents issus de pages web en cache ou en direct.

Lorsqu’une personne pose une question à un chatbot, un agent IA peut avoir besoin de lire plusieurs pages web pour y répondre. Les résultats de recherche standard ne renvoient souvent que des extraits. Récupérer directement une page peut renvoyer du HTML brut, truffé d’éléments de navigation, de bannières de cookies et de publicités. Les agents ont besoin du contexte de la page dans un format exploitable par un modèle, tandis que les développeurs ont besoin d’un moyen de contrôler le degré de fraîcheur requis pour ce contexte.
Nous lançons aujourd’hui Perplexity Context API, qui lit jusqu’à 10 URL et renvoie, pour chaque page, du Markdown propre, du HTML, des liens et des extraits basés sur la requête. Les informations proviennent du vaste index web de Perplexity ou d’une récupération en direct. Les agents peuvent définir la fraîcheur de chaque requête et vérifier la source de chaque résultat.
Context API prend en charge divers formats
Les agents peuvent lancer une requête en fournissant une liste d’URL et en précisant les formats de sortie. L’API renvoie un résultat pour chaque URL, dans le même ordre.
Context API prend en charge divers formats de réponse :
- Markdown : le contenu de la page en Markdown propre, prêt à être placé dans le contexte d’un modèle.
- HTML : le HTML de la page, pour les applications qui effectuent leur propre analyse syntaxique.
- Liens : les liens de la page sous forme d’URL absolues, sans doublons et dans l’ordre de la page, afin qu’un agent puisse décider où aller ensuite.
- Extraits : les passages de la page les plus pertinents pour une requête donnée, dans la limite de tokens fixée par le développeur pour chaque page.
Context API sélectionne dans chaque page les passages pertinents pour la requête, au lieu de générer un résumé. Le modèle reçoit ainsi la formulation d’origine de la page, mais uniquement les passages sélectionnés, ce qui réduit la quantité de texte à traiter.
Chaque résultat réussi inclut également des métadonnées telles que le titre, la description, la langue, l’auteur et la date de publication, ainsi que les balises Open Graph de la page. Pour générer le Markdown, la Context API découpe la page en blocs, puis un modèle évalue chaque bloc pour déterminer s’il s’agit de contenu principal ou de contenu passe-partout. Seuls les blocs de contenu sont conservés.
Indispensable pour les tâches qui exigent une vue d’ensemble
Trouver une page pertinente ne suffit pas toujours pour mener une tâche à bien. Grâce à Context API, les agents peuvent récupérer le contenu dont ils ont besoin à partir d’URL sélectionnées pour accomplir des tâches complexes.
- Implémenter une intégration d’API : un résultat de recherche peut identifier la bonne documentation sans inclure les paramètres requis, les instructions d’authentification ni les cas d’erreur. Context API peut aider un agent de codage à récupérer la documentation et les références de l’API afin d’écrire une intégration à partir de ces informations.
- Comparer les prix actuels : un prix affiché peut dépendre de limites d’utilisation, de conditions de facturation ou de critères d’éligibilité absents d’un extrait de résultat de recherche. Un agent peut demander une récupération en direct de pages de tarifs sélectionnées et lire ces conditions avant d’effectuer une comparaison.
- Répondre à des questions sur des politiques : un extrait de politique de retour peut indiquer le délai de retour standard, mais omettre les exceptions applicables à certains produits ou à certaines régions. Un agent d’assistance peut récupérer la page de la politique afin que sa réponse tienne compte de ces exceptions.
- Effectuer des recherches dans plusieurs sources : un extrait de résultat de recherche peut faire ressortir une conclusion sans la méthodologie, les réserves ou l’argumentation qui l’accompagnent. Un agent de recherche peut récupérer les articles et rapports sélectionnés, puis comparer les éléments de preuve plutôt que de s’appuyer uniquement sur des extraits.
Contrôlez la fraîcheur et gérez les URL de manière fiable
Par défaut, la Context API vérifie d’abord si l’index web de Perplexity contient une copie de la page récupérée au cours des deux derniers jours. Si ce n’est pas le cas, elle récupère la page en direct. Les développeurs peuvent définir max_age_seconds sur 0 pour toujours lire les pages en direct, par exemple pour les prix, les résultats sportifs ou l’actualité de dernière minute. Pour les documents de référence qui changent rarement, ils peuvent augmenter cette valeur. Définissez cache_only sur true pour les charges de travail qui ne doivent jamais déclencher de requête en direct.
Chaque résultat indique si le contenu provient d’une copie stockée ou d’une récupération en direct, ainsi que le moment où il a été récupéré.
Les URL d’une requête sont récupérées en parallèle, chacune avec son propre budget de temps et son propre statut. Une page lente ou inaccessible n’entraîne pas l’échec des autres. Le statut indique ce qui s’est passé pour chaque URL, afin qu’un agent puisse relancer uniquement les pages ayant expiré et conserver les autres.
Context API renvoie un contenu exploitable et complet
Nous avons comparé la Context API à Firecrawl, Exa, Parallel, Keenable et Context.dev sur 1 000 URL échantillonnées à partir de véritables requêtes de récupération d’agents. L’ensemble couvre 715 sites et comprend des sources gouvernementales et universitaires ainsi que des pages non anglophones. Un modèle juge distinct a ensuite évalué les résultats sans savoir quel fournisseur avait produit chacun d’eux.
Le graphique mesure les performances selon trois critères :
- Exploitabilité : la proportion d’URL ayant renvoyé le contenu réel de la page, et non une page d’erreur ou un résultat vide.
- Rappel des faits : le juge recense les faits clés trouvés sur une page, tous fournisseurs confondus, puis vérifie lesquels figurent dans chaque résultat. Une récupération échouée obtient un score de zéro.
- Précision du contenu : la part du texte renvoyé qui correspond au contenu de la page, et non à des bandeaux de cookies, à des éléments de navigation ou à des publicités, en moyenne sur l'ensemble des URL. Une récupération qui échoue obtient un score de zéro.
Lors de cette évaluation, la Context API a renvoyé un contenu exploitable pour 92,3 % des URL, a retrouvé 87,9 % des faits clés et a obtenu un score de 80,3 % en précision du contenu.
Tarifs
Context API coûte 1 $ pour 1 000 URL récupérées. Les développeurs paient pour chaque URL qui renvoie le statut ok. Les URL en échec ne sont pas facturées.
Premiers pas
curl --request POST https://api.perplexity.ai/v1/context \
--header "Authorization: Bearer $PERPLEXITY_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"urls": ["https://info.cern.ch/hypertext/WWW/TheProject.html"],
"formats": ["markdown"]
}'Chaque résultat renvoie le Markdown de la page, les passages correspondant à la requête, les métadonnées de la page et un statut. Vérifiez le statut de chaque résultat avant d’utiliser son contenu.
Consultez la documentation de Context API ou la référence de l’API.