GET /v1/cves

Accès programmatique à la base de vulnérabilités de TechWatchAlert : recherche multicritères et fiche complète (CVSS, EPSS, KEV, PoC, produits affectés). Données publiques — aucun projet requis.

Recherche de CVE

GET /api/v1/cves
Authorization: Bearer twa_votre_cle_ici

Paramètres de requête

Paramètre	Type	Description
q	string	Recherche dans l’ID, la description, le vendor ou le produit
severity	string	Filtre, virgule-séparé : CRITICAL,HIGH,MEDIUM,LOW
is_kev	boolean	true = uniquement les CVE du catalogue KEV de la CISA
has_poc	boolean	true = uniquement les CVE avec exploit public connu
vendor	string	Filtre par éditeur — cherché dans toutes les entrées affected
product	string	Filtre par produit — cherché dans toutes les entrées affected
match	string	partial (défaut) ou exact pour vendor/product
updated_since	string	Date ISO 8601 : ne rend que les CVE modifiées depuis
include	string	affected pour joindre les intervalles de versions à la liste
page	integer	Page (défaut 1)
page_size	integer	Taille de page, max 100 (défaut 20)

Recherche par produit

vendor et product examinent le couple principal et chaque entrée de affected. Une CVE qui touche Chrome, Edge et Electron est donc trouvable sous les trois — auparavant, seul le premier de la liste répondait.

match=exact évite le bruit de la correspondance partielle : product=java ramène aussi javascript, product=java_se&match=exact non. Recommandé pour un client automatisé.

Synchronisation incrémentale

updated_since rend les CVE modifiées, pas seulement publiées : une CVE reçoit son entrée KEV et son score CVSS des jours après sa parution.

Associé à include=affected, il permet de tenir un cache à jour sans jamais ouvrir la fiche de chaque CVE — les intervalles de versions arrivent directement dans la liste.

curl -H "Authorization: Bearer $TWA_API_KEY"   "https://app.techwatchalert.com/api/v1/cves?updated_since=2026-08-01T00:00:00Z&include=affected&page_size=100"

Réponse 200 OK

{
  "items": [
    {
      "cve_id": "CVE-2024-3094",
      "severity": "CRITICAL",
      "cvss_score": 10.0,
      "epss_score": 0.9412,
      "is_kev": true,
      "has_poc": true,
      "vendor": "xz",
      "product": "xz-utils",
      "date_published": "2024-03-29T00:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 20
}

Champs — Item

Champ	Type	Description
cve_id	string	Identifiant CVE
severity	string	CRITICAL, HIGH, MEDIUM, LOW, NONE, UNKNOWN
cvss_score	number | null	Score CVSS (0–10)
epss_score	number | null	Probabilité d’exploitation EPSS (0–1)
is_kev	boolean	Présent dans le catalogue KEV de la CISA
has_poc	boolean	Exploit / preuve de concept public connu
vendor	string | null	Éditeur principal
product	string | null	Produit principal
date_published	string (ISO 8601) | null	Date de publication
affected	array | null	Présent uniquement avec include=affected — mêmes champs que sur la fiche

Erreurs

Code	Détail	Cause
422	updated_since doit etre une date ISO 8601	updated_since illisible
422	string_pattern_mismatch	match vaut autre chose que partial ou exact
422	less_than_equal	page_size dépasse 100

Fiche d’une CVE

GET /api/v1/cves/{cve_id}
Authorization: Bearer twa_votre_cle_ici

Paramètres de chemin

Paramètre	Type	Description
cve_id	string	Identifiant CVE (ex. CVE-2024-3094)

Réponse 200 OK

En plus des champs de l’item de recherche :

Champ	Type	Description
description	string | null	Description en anglais
cvss_vector	string | null	Vecteur CVSS
epss_percentile	number | null	Percentile EPSS (0–1)
cwe_ids	array | null	Identifiants CWE associés
poc_count	integer	Nombre de PoC publics recensés
date_updated	string (ISO 8601) | null	Dernière mise à jour
affected	array	Produits affectés

Chaque entrée de affected : vendor, product, version_from, version_to, version_status, cpe.

Erreurs

Code	Détail	Cause
404	CVE introuvable	cve_id inexistant en base

Exemples

CVE critiques avec PoC public, paginées

curl -s \
  -H "Authorization: Bearer twa_votre_cle_ici" \
  "https://app.techwatchalert.com/api/v1/cves?severity=CRITICAL&has_poc=true&page=1&page_size=50" \
  | jq '.items[] | {cve: .cve_id, cvss: .cvss_score, epss: .epss_score}'

Fiche complète d’une CVE

curl -s \
  -H "Authorization: Bearer twa_votre_cle_ici" \
  https://app.techwatchalert.com/api/v1/cves/CVE-2024-3094 \
  | jq '{cve: .cve_id, kev: .is_kev, affected: [.affected[].product]}'