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
has_workaround	boolean	true = uniquement les CVE avec un contournement ou une atténuation connu (mesures provisoires) ; false = sans
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. exact ignore casse et séparateurs
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é.

exact ignore la casse et les séparateurs. Un même produit arrive ici depuis plusieurs sources, chacune avec sa convention : la base contient 7-Zip et 7-zip, Visual Studio Code et visual_studio_code. Demander une écriture précise reviendrait à la deviner, puisqu’elle n’est documentée nulle part et change d’un produit à l’autre.

La comparaison se fait donc en minuscules, _ et l’espace ramenés au tiret. Ces trois caractères séparent des mots, ils ne distinguent jamais deux logiciels — chrome et chromium restent bien deux produits.

Un produit, plusieurs orthographes

exact réconcilie l’écriture, pas le vocabulaire. notepad-plus-plus et notepad++ restent deux produits distincts, avec des CVE différentes, parce que les sources amont les nomment ainsi — la ponctuation n’est pas un séparateur.

Un client d’inventaire a donc intérêt à interroger les deux formes et à fusionner, ou à passer par vendor — qui regroupe les orthographes d’un même éditeur :

# 19 CVE sous une orthographe, 4 sous l'autre, 26 par l'éditeur
curl -H "Authorization: Bearer $TWA_API_KEY" \
  "https://app.techwatchalert.com/api/v1/cves?vendor=notepad-plus-plus&match=exact"

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,
      "maturite_exploit": "exploitee",
      "contournement_disponible": false,
      "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 (GitHub, Exploit-DB, Metasploit ou Nuclei)
maturite_exploit	string | null	Maturité de l’exploit, voir ci-dessous
contournement_disponible	boolean	Un contournement ou une atténuation de l’éditeur ou d’un CERT est connu ; le détail est dans mesures_provisoires de la fiche
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

Maturité de l’exploit

maturite_exploit résume, du plus grave au moins grave, ce que l’on sait de l’exploitation :

Valeur	Signification
exploitee	Exploitation avérée : catalogue KEV de la CISA, KEV de VulnCheck, EUVD de l’ENISA ou CERT-FR
outillee	Exploit outillé : un module Metasploit ou un modèle de détection Nuclei existe ; l’attaque est à la portée de tous, sans écrire de code
poc	Preuve de concept publique seulement : dépôt GitHub (recensé par nomi-sec/PoC-in-GitHub) ou exploit d’Exploit-DB
null	Rien de connu

Les sources sont relues chaque jour. Seuls l’identifiant, le titre, l’adresse, la date et le type de chaque exploit sont conservés, jamais leurs auteurs.

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 et d’exploits publics recensés, toutes sources
date_updated	string (ISO 8601) | null	Dernière mise à jour
affected	array	Produits affectés
mesures_provisoires	array	Contournements, atténuations et absence annoncée de correctif, voir ci-dessous

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

Mesures provisoires

Ce que l’éditeur ou un CERT propose en attendant (ou à défaut) d’un correctif, une entrée par avis et par catégorie :

Champ	Type	Description
categorie	string	workaround (contournement), mitigation (atténuation), none_available (pas de correctif disponible), no_fix_planned (aucun correctif prévu)
source	string	certfr, csaf-cisa, csaf-ncsc-nl, csaf-siemens
reference	string	Identifiant de l’avis (CERTFR-2026-ALE-005, ICSA-26-274-02, SSA-330084)
texte	string | null	Texte de la mesure, court ; null quand la licence de la source ne permet que la catégorie et le lien
url	string | null	Avis original
date	string (ISO 8601) | null	Date de mise à jour de l’avis
produits	array	Produits concernés, quand l’avis les nomme
republication	string | null	Éditeur d’origine d’un avis republié par la CISA (ABB, Hitachi Energy…)
lien_seulement	boolean	true : catégorie et lien seulement, le texte reste chez l’éditeur
attribution	string	Mention de la source à reproduire avec la donnée

Licences

Chaque source a ses conditions (page Sources et licences). Reprendre texte ailleurs suppose de garder attribution, url et, pour le CERT-FR (Licence Ouverte 2.0), date. Le lien vers l’avis original est obligatoire pour Siemens ProductCERT. Les avis d’éditeurs republiés par la CISA n’ont jamais de texte.

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]}'

Sources et licences des données

Les données renvoyées par cette route viennent de sources publiques : le programme CVE® (MITRE), le catalogue KEV de la CISA, VulnCheck KEV, l’EUVD de l’ENISA, le CERT-FR, l’EPSS de FIRST, et les bases de preuves de concept et d’exploits (PoC-in-GitHub, Exploit Database, Metasploit Framework, nuclei-templates). Elles gardent la licence de leur source, et les mentions d’attribution que ces licences demandent s’appliquent aussi à l’usage que vous en faites.

Les avis Ubuntu (Ubuntu Security Notices, sous licence CC BY-SA 4.0) sont affichés dans l’application mais ne sont pas renvoyés par l’API.

La liste des sources, leur licence, les mentions à reproduire et les notices de licence sont sur la page Sources et licences.