Learn R Programming

virustotal: R Client for the VirusTotal Public API v2.0 and v3.0

Use VirusTotal, a Google service that analyzes files and URLs for viruses, worms, trojans etc., provides category of the content hosted by a domain from a variety of prominent services, provides passive DNS information, among other things.

This package supports both VirusTotal API v2.0 (legacy) and v3.0 (current). The v3.0 API provides richer data including IoC relationships, sandbox dynamic analysis, static file information, YARA rules, and more comprehensive threat intelligence.

API Rate Limits:

  • Public API: 500 requests/day, 4 requests/minute
  • Premium API: No daily or rate limitations

Supported Operations:

  • Files: Upload, scan, get reports, download, comments, votes, relationships
  • URLs: Submit for analysis, get reports, comments, votes, relationships
  • Domains: Get reports, comments, votes, relationships, WHOIS data
  • IP Addresses: Get reports, comments, votes, relationships, passive DNS

See https://www.virustotal.com for more information.

Installation

To get the current released version from CRAN:

install.packages("virustotal")

To get the current development version from GitHub:

install.packages("devtools")
devtools::install_github("themains/virustotal", build_vignettes = TRUE)

Usage

To learn about how to use the package, read the vignette. Or launch the vignette within R:

# Using virustotal
vignette("using_virustotal", package = "virustotal")

License

Scripts are released under the MIT License.

Copy Link

Version

Install

install.packages('virustotal')

Monthly Downloads

189

Version

0.3.0

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Gaurav Sood

Last Published

September 3rd, 2025

Functions in virustotal (0.3.0)

set_key

Set API Key
virustotal2_GET

Base POST AND GET functions. Not exported.
get_domain_votes

Retrieve votes for an Internet domain
get_domain_comments

Retrieve comments for an Internet domain
file_report

Get File Scan Report
add_comments

Add comments on Files and URLs
get_file_download_url

Get download URL for a file
get_domain_info

Retrieve information about an Internet domain
get_domain_relationship

Retrieve related objects to an Internet domain
download_file

Download a file from VirusTotal
domain_report

Get Domain Report
get_file_comments

Retrieve comments for a file
get_ip_info

Retrieve information about an IP address
get_url_votes

Retrieve votes for a URL
get_url_comments

Retrieve comments for a URL
get_file_upload_url

Get file upload URL for large files
ip_report

Get IP Address Report
rate_limit

Rate Limits
get_file_relationships

Retrieve relationships for a file
post_domain_comments

Add a comment to an Internet domain
post_domain_votes

Add a vote for a hostname or domain
rescan_file

Request rescan of a file
get_ip_comments

Retrieve comments for an IP address
get_url_relationships

Retrieve relationships for a URL
virustotal-package

virustotal: Access Virustotal API
post_ip_comments

Add a comment to an IP address
post_ip_votes

Add a vote for a IP address
get_file_votes

Retrieve votes for a file
post_file_comments

Add a comment to a file
url_report

Get URL Report
virustotal2_POST

POST for V2 API
post_url_comments

Add a comment to a URL
post_url_votes

Add a vote to a URL
scan_file

Submit a file for scanning
post_file_votes

Add a vote to a file
get_ip_votes

Retrieve votes for an IP address
scan_url

Submit URL for scanning
virustotal_check

Request Response Verification
virustotal_POST

POST for the Current V3 API
virustotal_GET

GET for the Current V3 API