Virus Total Public/Private/Intel API
Project description
virustotal-api
Virus Total Public/Private/Intel API
Installation
$ pip install virustotal-api
Usage
import json
import hashlib
from virus_total_apis import PublicApi as VirusTotalPublicApi
API_KEY = 'Sign-Up for API Key at virustotal.com'
EICAR = "X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*"
EICAR_MD5 = hashlib.md5(EICAR).hexdigest()
vt = VirusTotalPublicApi(API_KEY)
response = vt.get_file_report(EICAR_MD5)
print json.dumps(response, sort_keys=False, indent=4)
Output:
{
"response_code": 200,
"results": {
"scan_id": "275a021bbfb6489e54d471899f7db9d1663fc695ec2fe2a2c4538aabf651fd0f-1397510237",
"sha1": "3395856ce81f2b7382dee72602f798b642f14140",
"resource": "44d88612fea8a8f36de82e1278abb02f",
"response_code": 1,
"scan_date": "2014-04-14 21:17:17",
"permalink": "https://www.virustotal.com/file/275a021bbfb6489e54d471899f7db9d1663fc695ec2fe2a2c4538aabf651fd0f/analysis/1397510237/",
"verbose_msg": "Scan finished, scan information embedded in this object",
"sha256": "275a021bbfb6489e54d471899f7db9d1663fc695ec2fe2a2c4538aabf651fd0f",
"positives": 49,
"total": 51,
"md5": "44d88612fea8a8f36de82e1278abb02f",
"scans": {
"Bkav": {
"detected": true,
"version": "1.3.0.4959",
"result": "DOS.EiracA.Trojan",
"update": "20140412"
},
"MicroWorld-eScan": {
"detected": true,
"version": "12.0.250.0",
"result": "EICAR-Test-File",
"update": "20140414"
},
"nProtect": {
"detected": true,
"version": "2014-04-14.02",
"result": "EICAR-Test-File",
"update": "20140414"
},
...<snip>...
"AVG": {
"detected": true,
"version": "13.0.0.3169",
"result": "EICAR_Test",
"update": "20140414"
},
"Panda": {
"detected": true,
"version": "10.0.3.5",
"result": "EICAR-AV-TEST-FILE",
"update": "20140414"
},
"Qihoo-360": {
"detected": true,
"version": "1.0.0.1015",
"result": "Trojan.Generic",
"update": "20140414"
}
}
}
}
Testing
To run the tests:
$ ./tests
Documentation
You’re looking at it.
Contributing
Fork it.
Create a branch (git checkout -b my_virus_total_api)
Commit your changes (git commit -am “Added Something Cool”)
Push to the branch (git push origin my_virus_total_api)
Open a [Pull Request](https://github.com/blacktop/virustotal-api/pulls)
Wait for me to figure out what the heck a pull request is…
Release History
1.1.2 (2016-04-13)
API Changes
Re-adding the ability to use files from memory as well as from disk. (credit: @tweemeterjop)
1.1.1 (2016-03-13)
API Changes
Adding file/url feed private API endpoint.
1.0.9 (2016-01-01)
Privacyfixes
Fix scan_file (upload to VT), do not leak full path. (credit: @Rafiot)
1.0.8 (2014-12-26)
Bugfixes
Fixed get_url_report method for the Private API (credit: @John-Lin)
1.0.7 (2014-10-17)
Bugfixes
Fixed get_network_traffic method to return the pcap data (credit: adrianherrera)
1.0.6 (2014-09-22)
Bugfixes
Fixed a small typo in the private API’s scan_file method (credit: adrianherrera)
1.0.5 (2014-05-18)
Bugfixes
Fixing README.rst for better PYPI presentation.
1.0.2 (2014-05-18)
API Changes
Changing folder structure so when people import it it is not dumb :(
1.0.1 (2014-04-14)
Bugfixes
Trying to fix setup.py for deploying to PYPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for virustotal_api-1.1.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5ffa4e8d803a0a8c2f7b764a702c46a5b331f9f7be94ba57b86e7e9fafa6a292 |
|
MD5 | 985632c0a052021a834235838e6932e0 |
|
BLAKE2b-256 | af2c5f171062b938f9354a22d827b6dacc8675e2a14e9d6fe09fd0e73cef2c19 |