Comment filtrer les résultats de l’API Brave Search par date ?

Définition : En octobre 2026, le paramètre de requête freshness de l’API Brave Search filtre les résultats de recherche web selon l’ancienneté des pages. Il accepte des limites d’ancienneté prédéfinies ou une plage de dates personnalisée et utilise la date la plus pertinente indiquée par le contenu, comme celle de publication ou de dernière modification.

Points clés

• Le guide Web Search de Brave répertorie pd, pw, pm et py comme valeurs prédéfinies du filtre d’ancienneté.
• La référence de l’API Web Search précise le format personnalisé YYYY-MM-DDtoYYYY-MM-DD, avec une date de début suivie d’une date de fin.
• Le guide d’authentification de Brave exige une clé API dans l’en-tête HTTP X-Subscription-Token pour chaque requête, y compris celles qui comportent un filtre de date.

Comment intégrer un filtre prédéfini à la requête ?

Le guide Web Search de Brave présente une requête utilisant freshness=pw pour rechercher des pages web de la semaine écoulée. Le paramètre accompagne la requête de recherche, nommée q, dans l’URL de la requête API. L’adaptation suivante de cet exemple lit la clé API dans la variable d’environnement BRAVE_API_KEY :

curl "https://api.search.brave.com/res/v1/web/search?q=machine+learning+tutorials&freshness=pw" \
  -H "X-Subscription-Token: $BRAVE_API_KEY"

La référence de l’API donne les limites d’ancienneté exactes :

Comment fonctionne une plage de dates personnalisée ?

Le guide Web Search donne 2022-04-01to2022-07-30 comme exemple de plage personnalisée. Les dates de début et de fin suivent chacune l’ordre année-mois-jour et sont reliées directement par le texte to en minuscules. La requête ci-dessous utilise cet intervalle documenté :

curl "https://api.search.brave.com/res/v1/web/search?q=machine+learning+tutorials&freshness=2022-04-01to2022-07-30" \
  -H "X-Subscription-Token: $BRAVE_API_KEY"

Le même paramètre freshness contient soit la valeur prédéfinie, soit l’intervalle personnalisé. Une plage personnalisée fournit des dates calendaires explicites ; l’exemple de filtre prédéfini du guide fournit une période relative couvrant la semaine écoulée.

Quels champs de la réponse permettent d’interpréter les dates ?

La référence de l’API définit page_age, dans chaque résultat web, comme la date de la page, fondée sur sa publication ou sa dernière modification. Elle définit aussi page_fetched comme la date de dernière récupération de la page web. Les deux champs sont des chaînes de caractères pouvant prendre la valeur null ; une réponse peut donc contenir une valeur nulle.

La référence fournit également web.results.age, qui exprime l’ancienneté sous une forme lisible, avec 2 days ago comme exemple. La date du contenu utilisée par le filtre d’ancienneté et la date de récupération décrivent des événements distincts.

Termes associés

• Brave Search API
• Localisation de Brave Search
• Dates de mise à jour des articles

Foire aux questions

Quelle valeur sélectionne les pages de la semaine écoulée ?

Utilisez freshness=pw. Le guide Web Search de Brave présente cette valeur dans sa requête de filtrage sur la semaine écoulée.

Le filtre d’ancienneté utilise-t-il uniquement la date de publication initiale ?

La référence de l’API décrit la date la plus pertinente indiquée par le contenu, qui peut être sa date de publication ou de dernière modification.

Comment fournir la clé API dans ces exemples ?

Définissez BRAVE_API_KEY dans l’environnement avant d’exécuter les commandes. Le guide d’authentification de Brave documente cette variable et recommande les variables d’environnement ou une gestion sécurisée de la configuration pour stocker les clés.

Sources

1. Brave, « Web Search API reference », sans date
2. Brave, « Web Search », sans date
3. Brave, « Authentication », sans date

---

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