https://github.com/virustotal/vt-graph-api
VirusTotal Graph API
https://github.com/virustotal/vt-graph-api
Last synced: about 1 year ago
JSON representation
VirusTotal Graph API
- Host: GitHub
- URL: https://github.com/virustotal/vt-graph-api
- Owner: VirusTotal
- License: apache-2.0
- Created: 2019-03-21T14:42:21.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-10-26T17:03:26.000Z (over 2 years ago)
- Last Synced: 2025-04-12T19:14:31.978Z (about 1 year ago)
- Language: Python
- Size: 6.22 MB
- Stars: 41
- Watchers: 22
- Forks: 12
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# VirusTotal Graph API
VirusTotal Graph API allows you programatically interact with VirusTotal dataset.
## Installing the API
Install VirusTotal Graph Python API.
```
git clone https://github.com/VirusTotal/vt_graph_api
cd vt_graph_api
pip install . --user
```
## Verifying the installation
```python
>>> import vt_graph_api
>>> vt_graph_api.__version__
X.X.X
```
## Documentation
For more information about how to use **vt_graph_api** visit the [documentation](https://virustotal.github.io/vt-graph-api/) page.
You may also want to take a look at some of our [example scripts](https://github.com/VirusTotal/vt-graph-api/tree/master/examples),
which besides doing useful work for you can be used as a guidance on how to use **vt_graph_api**.
In addition, you can find the documentation for the VirusTotal Graph REST API at the [API reference](https://developers.virustotal.com/v3.0/reference#graphs)
# Test it!
Use tox to test:
```
>>> tox
```
# Changelog
### V2.2.0
- Support for loading Graphs with special relationships (Groups, Intelligence, Livehunt, Retrohunt, Commonalities).
- New method for creating groups of nodes.
### V2.1.0
- Support for setting Graph representation.
### V2.0.0
- Removed `carbonblack_children` and `carbonblack_parent` relationships in File entity.
- Create a Collection from a Graph.
- Added **new entity** types:
- collection
- reference
- whois
- ssl_cert
- Added **new relationships**:
- Files: *dropped_files, collections, email_attachments, itw_ips, overlay_children, pe_resource_children, references, urls_for_embedded_js*
- Domains: *historical_ssl_certificates,
historical_whois,
caa_records,
cname_records,
mx_records,
ns_records,
soa_records,
collections,
references.*
- IP Addresses: *historical_ssl_certificates,
historical_whois,
collections,
references.*
- Urls: *contacted_domains,
contacted_ips,
redirects_to,
urls_related_by_tracker_id,
communicating_files,
referrer_files,
embedded_js_files,
collections,
references*
- Collections: *files,
domains,
ip_addresses,
urls,
references.*
- Whois: *network_location.*
### V1.1.3
- Bug fixing.
### V1.1.2
- Bug fixing.
### V1.1.1
- Bug fixing.
- Fixing documentation.
### V1.1.0
- Added download graph screenshot from VirusTotal.
### V1.0.1
- Fixing documentation.
### V1.0.0
---
- Added autosearch algorithm to find links between graph's nodes.
- Accept **MD5** and **SHA1** as valid ID for nodes with **file type**.
- Added **VTIntelligence** search for nodes without any information.
- Accept custom node types.
- Added load graph from VirusTotal.
- Added clone graph from VirusTotal.