Comment obtenir l’heure de la dernière récupération par l’index dans le contexte Brave ?

Définition : Brave LLM Context renvoie dans fetched_content_timestamp l’heure à laquelle l’index a effectué sa dernière récupération (fetch) d’une page référencée, exprimée en secondes Unix. L’ajout de enable_source_metadata=true permet de demander ce champ dans l’objet de métadonnées sources[url].

Points clés

• Brave LLM Context renvoie des segments (chunks) extraits des pages et des métadonnées sur les sources pour une application d’IA, tandis que la page de résultats de sa recherche Web traditionnelle utilise de courts extraits. La documentation de LLM Context de Brave décrit les métadonnées de la réponse comme organisées par URL.
• enable_source_metadata est un paramètre de requête booléen dont la valeur par défaut est false. Lorsqu’il est activé, il ajoute site_name, favicon, thumbnail, description et fetched_content_timestamp à chaque entrée sources[url].
• fetched_content_timestamp est un entier qui contient l’heure de la dernière récupération de la page par l’index, exprimée en secondes Unix. La référence de l’API de Brave indique que ce champ nécessite enable_source_metadata.
• La référence de l’API décrit cette option comme un enrichissement des métadonnées des sources dans l’attribut sources de la réponse et rappelle la valeur par défaut false.
• L’entrée du 31 juillet 2026 du journal des modifications de Brave mentionne fetched_content_timestamp parmi les champs ajoutés par enable_source_metadata.

Que décrit cet horodatage ?

La documentation du format de réponse de Brave définit sources comme les métadonnées de toutes les URL référencées, organisées par URL. Une entrée de source comprend le titre de la page, le nom d’hôte et le tableau age. Le tableau age représente une date indiquée par la page dans quatre positions fixes, tandis que fetched_content_timestamp enregistre le moment où l’index a récupéré la page pour la dernière fois.

Les deux champs répondent à des questions différentes. sources[url].age décrit une date associée à la page. sources[url].fetched_content_timestamp décrit un événement de l’index et s’exprime en secondes Unix. La documentation ne précise ni l’intervalle d’actualisation ni une valeur de repli pour chaque URL.

Comment demander ce champ ?

La référence de l’API de Brave présente enable_source_metadata comme un paramètre de requête booléen facultatif. La requête au point d’accès (endpoint) LLM Context doit lui attribuer la valeur true et conserver la clé API dans l’en-tête X-Subscription-Token.

curl -X GET "https://api.search.brave.com/res/v1/llm/context?q=tallest+mountains+in+the+world&enable_source_metadata=true" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"

Dans la réponse, le champ reste dans l’objet de source dont la clé est l’URL :

sources[url].fetched_content_timestamp

La documentation de LLM Context de Brave indique également que POST accepte les mêmes paramètres de requête dans un corps JSON avec Content-Type: application/json. Une intégration peut donc utiliser le même réglage booléen dans les deux formes de requête.

Comment interpréter la valeur renvoyée ?

La valeur se traite comme un horodatage entier provenant de l’index de Brave. Elle se convertit dans le format horaire nécessaire aux journaux ou à l’interface, en conservant la valeur d’origine pour comparer les réponses. La date de publication ou de modification de la page ne doit pas remplacer cette valeur : Brave documente ces dates dans le champ distinct age et définit ce champ comme l’heure de la dernière récupération par l’index.

L’horodatage décrit la copie utilisée par l’index de Brave lors de la récupération enregistrée. Il n’indique pas quand le propriétaire du site a modifié la page pour la dernière fois, et la documentation ne fournit aucun calendrier d’actualisation de l’index.

Termes associés

• En quoi Brave LLM Context diffère-t-il des résultats web classiques ?
• Comment filtrer les fragments de texte peu pertinents dans Brave LLM Context ?
• Brave Search API

Questions fréquentes

fetched_content_timestamp est-il renvoyé par défaut ?

Non. Brave documente false comme valeur par défaut de enable_source_metadata. Définissez ce paramètre sur true lorsque la réponse doit inclure les champs supplémentaires des sources.

La valeur est-elle une date ISO 8601 ?

Non. Le champ est un entier exprimé en secondes Unix. Le tableau age comprend une représentation ISO 8601 parmi ses quatre positions consacrées à la date de la page ; il s’agit d’une valeur distincte.

Une requête POST peut-elle inclure cette option ?

Oui. Brave documente que POST accepte les mêmes paramètres de requête dans un corps JSON. Vous pouvez donc y inclure enable_source_metadata avec les autres paramètres de la requête.

Sources

1. Brave Search API, « LLM Context: Web search for AI agents and chatbots », 31 juillet 2026
2. Brave Search API, « LLM Context Web search API for AI agents API Reference », sans date

---

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO