Skip to main content
VirusTotal logo
  • Category: security & identity tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 16
  • Triggers: 0
  • Slug: VIRUSTOTAL
  • Version: 20261101_00

Tools

Slug: VIRUSTOTAL_ADD_COMMENTTool to add a comment to a VirusTotal resource (file, URL, domain, or IP address). Use after analyzing a resource to leave contextual feedback. Provide exactly one identifier per call.

Input Parameters

string
URL resource identifier to comment on. Mutually exclusive with file, domain, and ip_address.
string
SHA-256 hash of the file to comment on. Mutually exclusive with url, domain, and ip_address.
string
required
The comment text to add.
string
Domain name to comment on. Mutually exclusive with file, url, and ip_address.
string
IP address to comment on. Mutually exclusive with file, url, and domain.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_ADD_VOTESubmit a harmless or malicious vote on a VirusTotal resource. The resource identifier determines the target: IPv4-shaped strings route to IP addresses, 64-character hexadecimal strings to files, dotted domain-shaped strings to domains, and other strings to URLs.

Input Parameters

object
required
The vote data object to submit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_GET_ANALYSISTool to retrieve the analysis report of a file or URL submission. Use after obtaining an analysis ID to fetch its detailed report. Analysis results may be incomplete immediately after submission; poll until the report status is ‘completed’ before treating results as final.

Input Parameters

string
required
The identifier of the analysis to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_GET_COMMENTSTool to retrieve the latest comments on a VirusTotal resource. Use when you need to review user-generated comments for a file, URL, domain, or IP after obtaining its identifier.

Input Parameters

string ("asc" | "desc")
Sort order by comment date (‘asc’ or ‘desc’)
integer
Number of comments to return per page (default: 10, max: 40)
string
Pagination cursor for fetching next page
string
required
Resource identifier to get comments for (SHA-256, URL, domain, or IP address)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_GET_DOMAIN_RELATIONSHIPSTool to retrieve relationship objects for a given domain. Use when you have a domain and need to explore its related entities.

Input Parameters

integer
Number of items to return per page (1-40). Defaults to server default if omitted.
string
Pagination cursor for fetching next page of results.
string
required
The domain name to query (e.g., ‘example.com’).
string ("communicating_files" | "referrer_files" | "downloaded_files" | "resolutions" | "subdomains" | "categories" | "whois" | "ssl_certificates" | "detected_downloaded_samples" | "detected_referrer_samples")
required
Type of relationship to retrieve. Allowed values: communicating_files, referrer_files, downloaded_files, resolutions, subdomains, categories, whois, ssl_certificates, detected_downloaded_samples, detected_referrer_samples.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_GET_DOMAIN_REPORTTool to retrieve the analysis report of a domain. Use when you need detailed insight on a domain’s reputation and analysis stats. No malicious signals on obscure or low-traffic domains may indicate limited analysis history rather than safety — treat sparse results as ‘unknown’, not ‘safe’. Covers external OSINT only (reputation, malware, SSL posture); cannot analyze internal/private assets.

Input Parameters

string
required
The domain name to retrieve the report for (e.g., ‘example.com’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_GET_FILE_REPORTTool to retrieve the analysis report of a file. Use when you have a file’s hash and need detailed scan metadata. Recently submitted files may return partial results; retry after a short delay before treating the report as final.

Input Parameters

string
required
Unique file identifier (SHA-256, SHA-1, MD5 hash or scan_id)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_GET_IP_ADDRESS_RELATIONSHIPSRetrieve objects related to an IP address by relationship type, including communicating or downloaded files and communicating URLs.

Input Parameters

string
required
The IPv4 or IPv6 address to query (e.g., ‘8.8.8.8’).
integer
Number of items to return per page (1-40). Defaults to server default if omitted.
string
Pagination cursor for fetching next page of results.
string ("communicating_files" | "downloaded_files" | "communicating_urls")
required
Type of relationship to retrieve. Allowed values: communicating_files, downloaded_files, communicating_urls.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_GET_IP_ADDRESS_REPORTTool to retrieve the analysis report of an IP address. Use when you need detailed insight on an IP’s reputation, ASN, country, and analysis stats. Low or zero detections indicate unknown risk, not safety — treat sparse data accordingly. Provides external OSINT only; insufficient as standalone compliance evidence.

Input Parameters

string
required
The IP address to retrieve the report for (IPv4 or IPv6) Note: this parameter is named ip, not ipAddress (used by ABUSEIPDB_CHECK_IP); using the wrong name causes validation failure.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_GET_METADATATool to retrieve VirusTotal metadata. Use when you need information about available privileges, relationships between resources (like files, domains, IPs, URLs), and supported antivirus engines.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_GET_URL_REPORTTool to retrieve the analysis report of a URL. Use when you have a URL identifier (base64-url without padding) and need detailed scan results, reputation, and metadata. Results may be incomplete immediately after submission; retry with short delays if scan engines are still processing before treating the report as final.

Input Parameters

string
required
Base64 URL identifier (RFC 4648 without padding) of the URL

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_GET_VOTESTool to retrieve votes on files, URLs, domains, or IP addresses. Use when you need to view community votes for a given object.

Input Parameters

integer
Maximum number of votes to retrieve (default: 10, max: 40).
string
Pagination cursor for fetching subsequent pages of results.
string
required
Identifier of the object (e.g., file hash, URL-encoded URL, domain name, or IP address).
string ("files" | "urls" | "domains" | "ip_addresses")
required
Type of the object to retrieve votes for: ‘files’, ‘urls’, ‘domains’, or ‘ip_addresses’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_RESCAN_FILETool to re-analyze a previously submitted file. Use when you need updated analysis results after an initial scan.

Input Parameters

string
required
Unique file identifier (SHA-256, SHA-1, or MD5 hash of the file) to re-analyze.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_SCAN_URLTool to submit a URL for scanning. Use when you have a URL and need to submit it to VirusTotal to obtain an analysis ID for later retrieval. The returned analysis ID is preliminary — scanning engines may not have finished. Poll VIRUSTOTAL_GET_URL_REPORT with the ID using short delays to retrieve complete results.

Input Parameters

string
required
The URL to be analyzed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_SEARCHTool to search for objects in the VirusTotal database. Use when locating files, URLs, domains, IPs, or comments matching a query. Supports pagination with limit and cursor.

Input Parameters

integer
Maximum number of items to return (1-40). Defaults to 10 if not specified.
string
required
Query string to search in the VirusTotal database. Can be a file hash, URL, domain, IP address, or an advanced search query.
string
Pagination cursor from a previous SEARCH response. Use to retrieve the next batch of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: VIRUSTOTAL_UPLOAD_FILEUpload binary file content to VirusTotal for scanning. This upload handles files up to 32 MB and returns an analysis identifier.

Input Parameters

string
required
Binary content of the file to upload.
string
Optional filename to use for the uploaded file.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not