README.md

VirusTotalPy

Open-source Python library for an easier interaction with the VirusTotal v3 API

Features

The latest Version 1.0.1 lets you analyse and scan a list of IPs, URLs and files up to 650MB.

Installation

Method 1:

pip install virustotalpy

Method 2:

git clone https://github.com/maxmmueller/virustotalpy.git

Method 3:

Download the latest Release

Usage

In order to use the API you need to sign up for a VirusTotal account and create an API key.

Code example:

from virustotalpy import Scanner

# replace this with your actual api key and username
API_KEY = "YOUR-API-KEY"
USER_NAME = "YOUR-VIRUSTOTAL-USERNAME"

scanner = Scanner(API_KEY, USER_NAME)

data = [
    "https://www.example.com",
    "192.168.0.1",
    "test.exe"
]

result = scanner.scan(data)
print(result)

Learn more

• Documentation and reference
• PyPI
• API reference

Contributing

Contributions to this project are welcome!

If you encounter any problems, find a bug or have feature requests, please open an issue.

Licence

Maximilian Müller 2021-2023 Apache License 2.0