VirusTotal Api v3 (Public & Enterprise)

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
  • 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 feed batch hourly
  • Url feeds
  • Get Url feed batch
  • Get Url feed batch hourly

Available feature flags

• enterprise
• feeds
• hunting

Usage

• Cargo.toml toml [dependencies] vt3 = "0.7.1"

• to enable enterprise features toml [dependencies] vt3 = { version = "0.7.1", features = ["enterprise"] }

• and then: to get ip information ```rust use vt3::VtClient;

fn main() { let apikey = match std::env::args() .skip(1) .next() .okorelse(|| "Please provide the api key!") { Ok(apikey) => apikey, Err(e) => { println!("{:?}", e); std::process::exit(1) } }; let ipaddress = "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 auser agent` for the client

```rust use vt3::VtClient;

fn main() { let apikey = match std::env::args() .skip(1) .next() .okorelse(|| "Please provide the api key!") { Ok(apikey) => apikey, Err(e) => { println!("{:?}", e); std::process::exit(1) } }; let ipaddress = "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

• https://developers.virustotal.com/v3.0/reference

License: MIT