How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

VirusTotal Threat Landscape & Vulnerability Intelligence & Reports & Analysis API

Threat Landscape & Vulnerability Intelligence & Reports & Analysis

VirusTotal Threat Landscape & Vulnerability Intelligence & Reports & Analysis API is one of 35 APIs that VirusTotal publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 16 operations across 10 paths, and defines 2 schemas. It is described by OpenAPI 3.0.3, at version 3.0.

Requests are made against a single base URL, https://www.virustotal.com/api/v3.

16 operations 10 paths 2 schemas 2 DELETE10 GET1 PATCH3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
3.0
Base URL
https://www.virustotal.com/api/v3
Authentication
API Key
Resource Areas
1

Authentication & Security 1

VirusTotal Threat Landscape & Vulnerability Intelligence & Reports & Analysis API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-apikey (VTApiKey). By default, every request must be authenticated.

  • VTApiKey — Personal VirusTotal / GTI API key. Found in the user menu of your VirusTotal account.

Paths & Operations 16

Across 10 paths, the API surfaces 16 operations — 2 DELETE, 10 GET, 1 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Threat Landscape & Vulnerability Intelligence & Reports & Analysis 16

Threat Landscape & Vulnerability Intelligence & Reports & Analysis

GET
/collections
VirusTotal List Threat Objects (Actor, Malware & Tool, Campaign, IoC Collection, Vulnerability, Report)
listThreats 4 params → 200400
POST
/collections
VirusTotal Create a New IoC Collection
createIocCollection body → 200400
GET
/collections/{id}
VirusTotal Get a Threat
getThreat 1 param → 200400
DELETE
/collections/{id}
VirusTotal Delete an IoC Collection
deleteIocCollection 1 param → 200400
PATCH
/collections/{id}
VirusTotal Update an IoC Collection
updateIocCollection 1 param body → 200400
GET
/collections/{id}/relationships/{relationship}
VirusTotal Get Object Descriptors Related to a Threat Object (Actor, Malware & Tool, Campaign, IoC Collection, Vulnerability, Report)
getThreatRelatedDescriptors 4 params → 200400
GET
/collections/{id}/{relationship}
VirusTotal Get Objects Related to a Threat Object (Actor, Malware & Tool, Campaign, IoC Collection, Vulnerability, Report)
getThreatRelationships 4 params → 200400
DELETE
/collections/{id}/{relationship}
VirusTotal Delete Items from an IoC Collection
deleteElementFromIocCollection 2 params body → 200400
POST
/collections/{id}/{relationship}
VirusTotal Add New Items to an IoC Collection
addElementToIocCollection 2 params body → 200400
GET
/collections/{id}/comments
VirusTotal Get Comments from a Threat Object (Actor, Malware & Tool, Campaign, IoC Collection, Vulnerability, Report)
getThreatComments 3 params → 200400
POST
/collections/{id}/comments
VirusTotal Add a Comment to a Threat Object (Actor, Malware & Tool, Campaign, IoC Collection, Vulnerability, Report) Object
createThreatComment 1 param body → 200400
GET
/collections/{id}/mitre_tree
VirusTotal Get MITRE Tactics and Techniques Associated with a Threat Object (Actor, Malware & Tool, Campaign, IoC Collection, Vulnerability, Report)
getThreatMitreTree 1 param → 200400
GET
/collections/{id}/search
VirusTotal Search IoCs Inside a Threat Object (Actor, Malware & Tool, Campaign, IoC Collection, Vulnerability, Report)
searchIocsInsideAThreat 7 params → 200400401404429
GET
/collections/{id}/download/{format}
VirusTotal Export IOCs from a Threat Object (Actor, Malware & Tool, Campaign, IoC Collection, Vulnerability, Report)
exportThreatIocs 2 params → 200400
GET
/collections/{id}/aggregations/download/{format}
VirusTotal Export Aggregations / Commonalities from a Threat Object (Actor, Malware & Tool, Campaign, IoC Collection, Vulnerability, Report)
exportThreatAggregations 2 params → 200400
GET
/collections/{id}/{relationship}/download/{format}
VirusTotal Export IOCs from a Given Threat Object (Actor, Malware & Tool, Campaign, IoC Collection, Vulnerability, Report)'s Relationship
exportIocsThreatRelationship 3 params → 200400

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are Error (2 properties), ErrorResponse (1 property). Each schema is shown below with its type and property counts.

Error
object
Standard VirusTotal API error envelope.
2 properties 2 required
ErrorResponse
object
Error response envelope returned by the VirusTotal API.
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

virustotal-threat-landscape-vulnerability-intelligence-reports-analysis-api-openapi.yml Raw ↑

Other APIs VirusTotal publishes across the network.

Google Threat Intelligence - Attack Surface Management (ASM)
Google Threat Intelligence - Digital Threat Monitoring (DTM)
VirusTotal Access Control - Group Management API
VirusTotal Access Control - Quota Management API
VirusTotal Access Control - Service Account Management API
VirusTotal Access Control - User Management API
VirusTotal IoC Feeds - Domain intelligence feed API
VirusTotal IoC Feeds - File intelligence feed API
VirusTotal IoC Feeds - IP intelligence feed API
VirusTotal IoC Feeds - Sandbox analyses feed API
VirusTotal IoC Feeds - URL intelligence feed API
VirusTotal IoC Investigation - Analyses, Submissions & Operations API
Where this information came from

This is an independent, third-party profile of VirusTotal Threat Landscape & Vulnerability Intelligence & Reports & Analysis API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.