VirusTotal API
Analyser fichiers, URLs, domaines et adresses IP contre des dizaines de moteurs antivirus via une seule API.
VirusTotal est un service d'analyse de menaces qui agrège les verdicts de dizaines de moteurs antivirus et d'outils de réputation. Son API REST (v3) permet d'envoyer des fichiers et des URLs pour analyse, et d'interroger la réputation de domaines, d'adresses IP et de hashs à partir des rapports déjà constitués. Elle s'adresse aux équipes de sécurité, aux analystes SOC, aux développeurs d'outils de threat intelligence et aux chercheurs qui veulent automatiser la détection de fichiers ou d'indicateurs malveillants. Une API publique gratuite couvre les besoins non commerciaux, tandis qu'une API Premium s'adresse aux usages professionnels et à fort volume.
Que propose l'API VirusTotal ?
Tarifs de l'API VirusTotal
Deux niveaux. Une API publique gratuite, réservée aux usages non commerciaux et soumise à des quotas stricts. Une API Premium (Private/Enterprise) à tarification sur devis, négociée avec VirusTotal selon le volume et les fonctionnalités, qui lève les limitations et débloque les capacités d'intelligence avancées.
Offre gratuite — API publique gratuite après création d'un compte Community : limitée à 4 requêtes par minute et 500 requêtes par jour, réservée aux applications non commerciales et grand public. Elle ne peut pas remplacer un antivirus commercial. Tout usage commercial ou à plus fort volume requiert l'API Premium.
Authentification & intégration
Clé API transmise dans l'en-tête HTTP x-apikey de chaque requête. La clé est obtenue gratuitement après inscription à un compte VirusTotal Community.
API REST renvoyant du JSON. L'analyse de fichiers et d'URLs est asynchrone : on soumet l'objet, on reçoit un identifiant d'analyse, puis on récupère le rapport une fois le scan terminé. Les requêtes de réputation (domaines, IP, hashs déjà connus) renvoient immédiatement les données existantes.
Cas d'usage de l'API VirusTotal
- Automatiser l'analyse de fichiers suspects dans un pipeline de sécurité ou un bac à sable.
- Vérifier la réputation d'URLs avant de les ouvrir ou de les autoriser dans un filtre.
- Enrichir des indicateurs de compromission (hashs, IP, domaines) dans un SIEM ou une plateforme de threat intelligence.
- Contrôler en masse une liste de domaines ou d'adresses IP pour détecter les éléments malveillants.
- Intégrer un score de réputation de fichiers dans un outil interne de détection.
- Mener des recherches sur des campagnes malveillantes via la base VT Intelligence (API Premium).
✓ Points forts
- Agrégation des verdicts de dizaines de moteurs antivirus et de sources de réputation en un seul appel.
- Couvre fichiers, URLs, domaines et adresses IP avec des rapports détaillés.
- API publique gratuite suffisante pour le prototypage et les usages non commerciaux.
- API Premium puissante (Intelligence, livehunt, retrohunt) pour les équipes de sécurité avancées.
- Authentification simple par clé et réponses JSON faciles à intégrer.
⚠ Limites
- L'API gratuite est très limitée (4 req/min, 500 req/jour) et interdite en usage commercial.
- Les fonctions avancées et les quotas élevés nécessitent une API Premium dont le tarif est sur devis.
- L'analyse de fichiers est asynchrone : il faut gérer l'attente et le polling du rapport.
- Les données partagées sur l'API publique peuvent être vues par la communauté, ce qui pose des questions de confidentialité.
Questions fréquentes sur l'API VirusTotal
VirusTotal propose-t-il une API gratuite ?
Oui, une API publique gratuite est accessible après création d'un compte Community. Elle est limitée à 4 requêtes par minute et 500 par jour, et réservée aux usages non commerciaux et grand public.
Comment s'authentifier à l'API ?
Avec une clé API transmise dans l'en-tête HTTP x-apikey de chaque requête. La clé est fournie gratuitement après inscription à un compte VirusTotal Community.
Quelle différence entre l'API publique et l'API Premium ?
L'API publique est gratuite mais limitée et réservée aux usages non commerciaux. L'API Premium, sur devis, lève les quotas et débloque les fonctions avancées (VT Intelligence, téléchargement de fichiers, livehunt, retrohunt) pour les usages professionnels.
Comment analyser un fichier avec l'API ?
On envoie le fichier via l'endpoint Files, on reçoit un identifiant d'analyse, puis on interroge l'endpoint d'analyse pour récupérer le rapport une fois le scan terminé par les moteurs antivirus.
Peut-on l'utiliser dans un produit commercial ?
Pas avec l'API publique gratuite, qui est explicitement interdite en usage commercial. Il faut souscrire à l'API Premium pour intégrer VirusTotal dans un produit ou service commercial.
Peut-on vérifier la réputation d'une IP ou d'un domaine ?
Oui, via les endpoints Domains et IP Addresses : ils renvoient la réputation, les résolutions DNS, la géolocalisation, le propriétaire et les fichiers ou URLs associés, à partir des données déjà collectées par VirusTotal.
