Recherche d'actualités

Nécessite une clé API : Obtenez-en une sur https://api.search.brave.com

Plan : Inclus dans le plan Search. Consultez https://api-dashboard.search.brave.com/app/subscriptions/subscribe

Démarrage rapide (cURL)

Recherche basique

curl -s "https://api.search.brave.com/res/v1/news/search?q=space+exploration" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"

Actualités récentes (dernières 24 heures)

curl -s "https://api.search.brave.com/res/v1/news/search" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
  -G \
  --data-urlencode "q=cybersecurity" \
  --data-urlencode "country=US" \
  --data-urlencode "freshness=pd" \
  --data-urlencode "count=20"

Filtre par plage de dates

curl -s "https://api.search.brave.com/res/v1/news/search" \
  -H "Accept: application/json" \
  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
  -G \
  --data-urlencode "q=climate summit" \
  --data-urlencode "freshness=2026-01-01to2026-01-31"

Endpoint

GET https://api.search.brave.com/res/v1/news/search
POST https://api.search.brave.com/res/v1/news/search

Authentification : En-tête X-Subscription-Token: <API_KEY>

Remarque : GET et POST sont tous deux supportés. POST est utile pour les requêtes longues ou les Goggles complexes.

Paramètres

Valeurs de freshness

Format de réponse

{
  "type": "news",
  "query": {
    "original": "space exploration"
  },
  "results": [
    {
      "type": "news_result",
      "title": "New Developments in Space Exploration",
      "url": "https://news.example.com/space-exploration",
      "description": "Recent missions have advanced our understanding of...",
      "age": "2 hours ago",
      "page_age": "2026-01-15T14:30:00",
      "page_fetched": "2026-01-15T15:00:00Z",
      "meta_url": {
        "scheme": "https",
        "netloc": "news.example.com",
        "hostname": "news.example.com",
        "favicon": "https://imgs.search.brave.com/favicon/news.example.com",
        "path": "/space-exploration"
      },
      "thumbnail": {
        "src": "https://imgs.search.brave.com/..."
      }
    }
  ]
}

Champs de réponse

Goggles (Classement personnalisé) — Unique à Brave

Goggles vous permet de reclasser les résultats d'actualités — augmenter la visibilité de sources fiables ou supprimer les sources indésirables.

Les goggles hébergées doivent être sur GitHub/GitLab, inclure les en-têtes ! name:, ! description:, ! author:, et être enregistrées sur https://search.brave.com/goggles/create. Les règles en ligne ne nécessitent pas d'enregistrement.

Syntaxe : $boost=N / $downrank=N (1–10), $discard, $site=example.com. Combinez avec des virgules : $site=example.com,boost=3. Séparez les règles avec \n (%0A).

Liste d'autorisation : $discard\n$site=docs.python.org\n$site=developer.mozilla.org — Liste de blocage : $discard,site=pinterest.com\n$discard,site=quora.com

Ressources : Découvrir · Syntaxe · Démarrage rapide

Opérateurs de recherche

Utilisez les opérateurs de recherche pour affiner les résultats :

• site:local-paper.com - Limiter à un site d'actualités spécifique
• "exact phrase" - Correspondance de phrase exacte
• -exclude - Exclure un terme

Mettez operators=false pour désactiver l'analyse des opérateurs.

Cas d'usage

• Surveillance des infos en direct : Utilisez freshness=pd pour les articles les plus récents sur un sujet.
• Flux d'actualités personnalisés avec Goggles : Augmentez les sources fiables et supprimez les autres sources — unique à Brave.
• Recherche historique d'actualités : Utilisez freshness=YYYY-MM-DDtoYYYY-MM-DD pour trouver des articles de périodes spécifiques.
• Actualités multilingues : Combinez country, search_lang et ui_lang pour des résultats cross-locale.
• Pipelines de données : Mettez include_fetch_metadata=true pour fetched_content_timestamp sur chaque résultat.

Remarques

• SafeSearch : Par défaut strict
• Pagination : Utilisez offset (0-9) avec count
• Extraits supplémentaires : Jusqu'à 5 extraits supplémentaires quand extra_snippets=true