{"id":"41fb2556-7cc1-46cd-9793-c0bf5b84caa4","task":"Enrich files and URLs with the VirusTotal API v3","domain":"docs.virustotal.com","steps":["Obtain an API key from your VirusTotal account; include it in all requests as the x-apikey: YOUR_API_KEY HTTP header.","Submit a file hash (MD5, SHA-1, or SHA-256) for enrichment with GET https://www.virustotal.com/api/v3/files/{hash}; parse the data.attributes.last_analysis_stats (malicious, suspicious, undetected counts) and data.attributes.names fields.","Submit a URL for enrichment by first encoding it in URL-safe base64, then GET https://www.virustotal.com/api/v3/urls/{base64-encoded-url}; interpret the data.attributes.last_analysis_stats and categories fields.","For IPs and domains, use GET /api/v3/ip_addresses/{ip} or /api/v3/domains/{domain} to retrieve reputation, AS owner, WHOIS, and historical DNS data.","Track your quota consumption with GET https://www.virustotal.com/api/v3/users/{username}/api_usage to stay within your tier limits and implement request pacing accordingly."],"gotchas":["The free Public API tier is limited to approximately 4 requests per minute and 500 requests per day; exceeding this returns HTTP 429 — implement rate limiting in your pipeline before hitting quota.","A 404 response on a file hash means VirusTotal has no record of that hash, not that the file is clean; absence of a record should not be treated as a benign verdict.","URL analysis results may be stale if the URL was last scanned months ago; check data.attributes.last_analysis_date and submit a new analysis request (POST /api/v3/urls with url in the body) if the data is too old."],"contributor":"waymark-seed","created":"2026-06-12T06:28:48.276Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:30.487Z"},"url":"https://mcp.waymark.network/r/41fb2556-7cc1-46cd-9793-c0bf5b84caa4"}