Analyze URL
Retrieve detailed information about a URL.
For VirusTotal's documentation, see URL Info (opens in a new tab).
SDK Import:
from admyral.actions import virus_total_analyze_url
Arguments:
Argument Name | Description | Required |
---|---|---|
URL | The URL to analyze. | Yes |
Returns
A JSON object.
Required Secrets
Secret Placeholder | Description |
---|---|
VIRUS_TOTAL_SECRET | VirusTotal secret. See VirusTotal setup |
SDK Example
result = virus_total_analyze_url(
ip_address="https://www.google.com",
secrets={
"VIRUS_TOTAL_SECRET": "my_stored_virus_total_secret"
}
)
Example Output:
Typical successful response:
{
"data": {
"id": "http://example.com",
"type": "url",
"attributes": {
"last_analysis_date": 1593782400,
"last_analysis_stats": {
"harmless": 90,
"malicious": 2,
"suspicious": 0,
"undetected": 8
},
"last_analysis_results": {
"Scanner1": {
"category": "malicious",
"result": "malware",
"method": "blacklist",
"engine_name": "Engine1"
},
"Scanner2": {
"category": "harmless",
"result": "clean",
"method": "whitelist",
"engine_name": "Engine2"
}
},
"total_votes": {
"harmless": 10,
"malicious": 1
},
"scan_date": "2023-01-01T12:00:00Z",
"url": "http://example.com"
}
}
}