get
https://www.virustotal.com/api/v3/collections///download/
Special privileges requiredThreat Actors and Campaigns are only available to users with the Google Threat Intelligence (Google TI) Enterprise or Enterprise Plus licenses.
Examples
Export files related to a given threat actor.
import requests
import urllib
object_id = "threat-actor--bcaaad6f-0597-4b89-b69b-84a6be2b7bc3"
relationship = "files"
format = "stix"
url = f"https://www.virustotal.com/api/v3/collections/{object_id}/{relationship}/download/{format}"
headers = {"accept": "application/json","x-apikey": <api-key>}
response = requests.get(url, headers=headers)Export files related to a given malware or toolkit.
import requests
import urllib
object_id = "malware--350aa703-7750-5e07-997b-476375955828"
relationship = "files"
format = "stix"
url = f"https://www.virustotal.com/api/v3/collections/{object_id}/{relationship}/download/{format}"
headers = {"accept": "application/json","x-apikey": <api-key>}
response = requests.get(url, headers=headers)Export files related to a given campaign.
import requests
import urllib
object_id = "campaign--24f96f40-b2fa-512c-b1da-2f22a949d12d"
relationship = "files"
format = "stix"
url = f"https://www.virustotal.com/api/v3/collections/{object_id}/{relationship}/download/{format}"
headers = {"accept": "application/json","x-apikey": <api-key>}
response = requests.get(url, headers=headers)Export files related to a given IoC collection.
import requests
import urllib
object_id = "alienvault_64edfc5ab93abb1407070292"
relationship = "files"
format = "stix"
url = f"https://www.virustotal.com/api/v3/collections/{object_id}/{relationship}/download/{format}"
headers = {"accept": "application/json","x-apikey": <api-key>}
response = requests.get(url, headers=headers)