💡 ULASAN & REFERENSI • DIPERBARUI: 21 October 2026 • REDAKSI AZWINN

Daftar Endpoint API VirusTotal v3: Panduan Lengkap

VirusTotal API v3 menyediakan akses terprogram ke pangkalan data ancaman siber global untuk menganalisis file, URL, domain, dan alamat IP. Seluruh permintaan menggunakan basis URL resmi https://www.virustotal.com/api/v3 dengan autentikasi wajib menyertakan header x-apikey yang berisi kunci API privat pengguna.

Daftar Kategori Endpoint VirusTotal API v3

Struktur endpoint dikelompokkan berdasarkan entitas objek keamanan yang dianalisis. Berikut adalah tabel komparasi fungsi utama beserta metode HTTP dan jalur endpoint yang paling sering digunakan dalam otomatisasi Security Operations Center (SOC) dan pencegahan malware.

Kategori Entitas Fungsi Utama Metode HTTP Path Endpoint API v3
Files Mengirim file untuk analisis atau mengambil laporan hasil pemindaian. GET, POST /files, /files/{id}
URLs Memindai URL mencurigakan atau memeriksa laporan reputasi web. GET, POST /urls, /urls/{id}
IP Addresses Memeriksa aktivitas dan reputasi alamat IP tertentu di internet. GET /ip_addresses/{ip}
Domains Analisis resolusi DNS, sertifikat SSL, dan reputasi nama domain. GET /domains/{domain}
Analyses Mengambil status antrean atau hasil dari submission tugas asinkron. GET /analyses/{id}
Comments Menambah atau membaca komentar komunitas mengenai suatu IOC. GET, POST /{entity}/{id}/comments

Contoh Implementasi Teknis Endpoint Files

Untuk memeriksa laporan analisis file menggunakan nilai hash SHA-256, Anda dapat mengirimkan permintaan HTTP GET ke endpoint /files/{id}. Batas tingkat (rate limit) standar untuk akun publik gratis adalah 4 permintaan per menit, sementara akun berbayar (Premium/Enterprise) mendapatkan kuota yang lebih tinggi.

curl --request GET \
  --url 'https://www.virustotal.com/api/v3/files/f14a019d592dbdbab50ef620e74bcf6b5c328e1cc65b05763f45c228229b47e5' \
  --header 'x-apikey: YOUR_API_KEY_HERE'

Langkah-Langkah Integrasi API

  1. Dapatkan kunci API (API Key) secara gratis dengan mendaftarkan akun di situs resmi VirusTotal.
  2. Simpan kunci API dalam variabel lingkungan (environment variable) sistem untuk menjaga keamanan kredensial.
  3. Gunakan pustaka HTTP klien pilihan Anda (seperti requests pada Python atau axios pada Node.js) untuk memanggil endpoint yang diinginkan.
  4. Tangani respons JSON yang dikembalikan, periksa status kode HTTP (misalnya 200 untuk sukses, 403 untuk kesalahan autentikasi, atau 429 jika melampaui batas kuota).

Endpoint Tambahan untuk Threat Intelligence

Selain entitas dasar, VirusTotal menyediakan endpoint tingkat lanjut yang mendukung investigasi ancaman mendalam:

  • /intelligence/search: Melakukan pencarian tingkat lanjut menggunakan kueri penelusuran mirip sintaksis Google (misalnya type:peexe engines:kaspersky positives:5+).
  • /graphs: Membuat dan mengelola grafik visual hubungan antar-indikator kompromi (IOC).
  • /hunting/notifications: Mengambil notifikasi aturan YARA aktif yang mendeteksi sampel malware baru.

Pastikan untuk selalu merujuk pada dokumentasi resmi pengembang VirusTotal karena penambahan endpoint baru atau perubahan skema respons JSON dapat diperbarui sewaktu-waktu oleh penyedia layanan.

🔍 Orang Lain Juga Mencari Ini