Présentation du service

Le Web Search API de Cloudflare est disponible en version bêta depuis le 2 octobre 2026. Il permet aux agents d’intelligence artificielle et aux applications de récupérer des résultats de recherche en temps réel, évitant ainsi la dépendance aux connaissances figées du modèle. Au lancement, trois fournisseurs sont proposés : Ceramic.ai, Exa et Linkup. Tous respectent la politique de Zero Data Retention appliquée par Cloudflare et adhèrent aux standards de verified bot crawling de la plateforme.

Architecture et intégration

L’API s’exécute via AI Gateway. Chaque requête de recherche est ainsi enregistrée dans les journaux du gateway et facturée aux crédits AI Gateway selon le tarif public du fournisseur, sans majoration supplémentaire. Cette architecture centralise le suivi d’usage et simplifie la facturation. Les développeurs peuvent également fournir leur propre clé d’API fournisseur, ce qui ajoute une couche de flexibilité pour des besoins spécifiques.

curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/websearch/ \
  --request POST \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "query": "What are some fun things to do in Salt Lake City as fall approaches?",
    "provider": "ceramic",
    "limit": 5,
    "options": { "gateway": { "id": "default" } }
  }'

Le même appel peut être réalisé depuis un Worker Cloudflare grâce à la liaison AI :

const response = await env.AI.websearch({
  gatewayId: "default",
  query: "What are some fun things to do in Salt Lake City as fall approaches?",
  provider: "exa",
  limit: 5,
});
const results = await response.json();

Analyse des implications techniques

Le choix de trois fournisseurs initiaux crée un environnement de comparaison de performances et de couverture de l’indexation web. La contrainte Zero Data Retention implique que Cloudflare ne conserve aucune donnée de requête, ce qui réduit les risques de fuite d’informations sensibles mais nécessite que chaque fournisseur gère séparément la conformité au RGPD ou à d’autres régulations. L’intégration au AI Gateway garantit que les métriques de latence et les taux d’erreur sont visibles dans les tableaux de bord existants, facilitant le diagnostic en production.

Le modèle de facturation basé sur les prix listés par chaque fournisseur évite les marges additionnelles, mais introduit une dépendance directe aux variations tarifaires externes. En phase bêta, la disponibilité se limite aux trois partenaires mentionnés ; l’ajout de nouveaux fournisseurs dépendra de la validation de leurs politiques de bot crawling et de rétention de données. Enfin, l’API repose sur le protocole HTTPS standard et accepte le format JSON, ce qui simplifie son adoption dans les stacks modernes sans nécessiter de bibliothèques spécifiques.