vt3

VirusTotal REST API v3 (Public & Enterprise)

18 releases

0.7.3 Apr 12, 2024
0.7.2 May 7, 2023
0.7.1 Jun 20, 2021
0.6.0 Jun 20, 2021
0.3.7 Jun 14, 2021

#238 in Web programming

26 downloads per month

Custom license

100KB
2K SLoC

VirusTotal Api v3 (Public & Enterprise)

Crates.io Documentation docs.rs Build Status GitHub license

VT3 provides an easy api interface to use VirusTotal v3 REST endpoints, including those exclusive to VirusTotal Enterprise. See below for list of available API's:

  • Public API
    • IP
      • Get IP information
      • Get Comments
      • Add Comments
      • List Votes
      • Add Votes
      • List Ip related IDs/Objects
    • Domain
      • Get Domain information
    • File
      • Get File information
      • Upload File to Scan
      • File ReScan
    • Url
      • Get Url information
      • Get Url information by ID
      • Url Scan
      • Url ReScan
  • Enterprise - features = ["enterprise"]
    • Users & Groups
      • Get User information
      • Delete a User
      • API Usage
      • Overall Quotas
      • Get Group information
      • Get all Group Members
      • Get Group API Usage
  • Hunting (Enterprise) - features = ["hunting"]
    • Live hunt
      • Get Live hunt Rulesets
      • Get Ruleset by ruleset id
      • Create Ruleset
      • Delete Ruleset
      • Update Ruleset
    • Retro hunt
      • Get Retrohunt jobs
      • Get Retrohunt job by job id
      • Create a Retrohunt job
      • Delete a Retrohunt job
      • Abort a Retrohunt job
  • Feeds (Enterprise) - features = ["feeds"]
    • File feeds
      • Get file feed batch
      • Get file behaviours feed batch
      • Get file feed batch hourly
      • Get file behaviours feed batch hourly
    • Url feeds
      • Get Url feed batch
      • Get Url feed batch hourly

Available feature flags

  • enterprise
  • feeds
  • hunting

Usage

  • Cargo.toml
[dependencies]
vt3 = "0.7.2"
  • to enable enterprise features
[dependencies]
vt3 = { version = "0.7.2", features = ["enterprise"] }
  • and then: to get ip information
use vt3::VtClient;

fn main() {
    let api_key = match std::env::args()
        .skip(1)
        .next()
        .ok_or_else(|| "Please provide the api key!")
    {
        Ok(api_key) => api_key,
        Err(e) => {
            println!("{:?}", e);
            std::process::exit(1)
        }
    };
    let ip_address = "5.2.69.42";

    let res = VtClient::new(&api_key).ip_info(ip_address);
    match res {
        Ok(report) => println!("{:#?}", report),
        Err(e) => println!("Error: {}", e.to_string()),
    }
}
  • Providing a user agent for the client
use vt3::VtClient;

fn main() {
    let api_key = match std::env::args()
        .skip(1)
        .next()
        .ok_or_else(|| "Please provide the api key!")
    {
        Ok(api_key) => api_key,
        Err(e) => {
            println!("{:?}", e);
            std::process::exit(1)
        }
    };
    let ip_address = "5.2.69.42";

    let res = VtClient::new(&api_key)
        .user_agent("Chrome for Windows")
        .ip_info(ip_address);
    match res {
        Ok(report) => println!("{:#?}", report),
        Err(e) => println!("Error: {}", e.to_string()),
    }
}

Examples

To run the examples - Universal API Endpoints:

  • Domain info: cargo run --example domain_info <your_api_key>
  • IP info: cargo run --example ip_info <your_api_key>
  • URL info: cargo run --example url_info <your_api_key>
  • URL info by id: cargo run --example url_info_by_id <your_api_key>
  • URL rescan: cargo run --example url_rescan <your_api_key>
  • File info: cargo run --example file_info <your_api_key>
  • File scan: cargo run --example file_scan <your_api_key>
  • File rescan: cargo run --example file_rescan <your_api_key>
  • Get latest comments: cargo run --example get_latest_comments <your_api_key>
  • Get comment by id: cargo run --example get_comment <your_api_key>

To run the examples - Enterprise API Endpoints:

  • Get user information: cargo run --example user_info --features="enterprise" <your_api_key> <user_id>
  • Delete a user: cargo run --example delete_user --features="enterprise" <your_api_key> <user_id>
  • Get Api usage info: cargo run --example api_usage --features="enterprise" <your_api_key> <user_id>
  • Get overall quotas for user: cargo run --example overall_quotas --features="enterprise" <your_api_key> <user_id>
  • Get group information: cargo run --example group_info --features="enterprise" <your_api_key> <group_id>
  • Get group api usage: cargo run --example group_api_usage --features="enterprise" <your_api_key> <group_id>
  • Get group members: cargo run --example group_members --features="enterprise" <your_api_key> <group_id>

To run the examples - Hunting API Endpoint:

  • Get Livehunt rulesets: cargo run --example livehunt_get_rulesets --features="hunting" <your_api_key>
  • Get Retrohunt jobs: cargo run --example retrohunt_jobs --features="hunting" <your_api_key>

VT Developer reference


License: MIT

Dependencies

~4–14MB
~200K SLoC