Skip to main content

Cotool + VirusTotal

Connect VirusTotal to Cotool so agents check file hashes, URLs, domains, and IPs during triage and follow VirusTotal relationships for deeper investigations.

Threat Intelligence
Updated

The short answer

VirusTotal is the enrichment step in many Cotool agent workflows: agents check file hashes, URLs, domains, and IPs from an alert in VirusTotal and use the result in their verdict, and they page through VirusTotal relationships for deeper investigations.[1][2][5]

How it connects: Cotool calls VirusTotal API v3 with your API key, which VirusTotal expects in the x-apikey header. Agents' outbound access can be limited to allowed hosts such as api.virustotal.com.[3][8]

What Cotool uses from VirusTotal

File reports
Given an MD5, SHA-1, or SHA-256 hash, VirusTotal returns the analysis report for the file. Agents use it to decide whether a file in an alert is known malware.[6][7]
URL, domain, and IP reports
VirusTotal returns analysis reports with reputation for URLs, domains, and IP addresses, which agents use to enrich phishing links, publisher domains, and connection targets.[2][7]
Relationships
Cotool expanded VirusTotal relationship pagination for deeper investigations. VirusTotal's Premium API exposes relationships such as embedded domains, embedded IPs, and contacted domains.[1][9]

Detections, hunts, and triage

Hash check in endpoint triageTriage
Cotool's docs show a simple alert path where the agent gets alert details, checks the hash in VirusTotal, and updates the ticket, with planning skipped because the task is short.[6]
Publisher check for a risky OAuth appResponse
Cotool's OAuth Grant Responder checks the app publisher's domain in VirusTotal before tracing what the token touched and asking #security about revocation.[2]
Pivot from one indicatorHunt
From a malicious domain, a hunt follows VirusTotal relationships to related IPs and files, then searches your logs for any of them.[1][4][9]

Setup and permissions

Copy your API key from the user menu of your VirusTotal account.[8]

PermissionAccess
API keyAuthenticates every request through the `x-apikey` header.[8]Read
  • VirusTotal's Public API allows 500 requests per day at 4 requests per minute and must not be used in commercial products or services. The Premium API's limits follow your license.[9]

How Cotool works with VirusTotal

  • Cotool's docs describe agents fetching data from Splunk, enriching with VirusTotal, and updating Jira in one run.[5]

FAQ

Can I use a free VirusTotal key?
VirusTotal states the Public API must not be used in commercial products or services and is limited to 4 requests per minute. Check your license before connecting a public key.[9]

Sources

  1. Changelog (Cotool docs) · accessed November 16, 2026
  2. Respond to every signal (Cotool Respond) · accessed November 16, 2026
  3. AI SOC (Cotool) · accessed November 16, 2026
  4. Threat hunting (Cotool Hunt) · accessed November 16, 2026
  5. What is an agent (Cotool docs) · accessed November 16, 2026
  6. Planning modes (Cotool docs) · accessed November 16, 2026
  7. VirusTotal API v3 overview (VirusTotal docs) · accessed November 16, 2026
  8. Authentication (VirusTotal docs) · accessed November 16, 2026
  9. Public vs Premium API (VirusTotal docs) · accessed November 16, 2026

Related integrations

All integrations

Use cases with VirusTotal

Attackers are scaling with tokens

Cotool helps defenders operate at machine speed. See how security teams are scaling Detection & Response.

Book a demo