VirusTotal API Key memberikan akses bagi pengembang dan analis keamanan siber untuk mengintegrasikan pemindaian file, URL, domain, dan alamat IP ke dalam sistem eksternal secara otomatis. Untuk pengguna umum dan penelitian dasar, VirusTotal menyediakan tier publik gratis dengan batasan ketat berupa 4 permintaan (request) per menit dan maksimal 500 permintaan per hari.
Memahami batas penggunaan (usage limits) ini sangat krusial agar skrip otomatisasi atau aplikasi Anda tidak mengalami pemblokiran sementara (HTTP 429 Too Many Requests). Artikel ini merinci kuota API, aturan penggunaan, tabel komparasi tier, serta cara mengoptimalkan pemanggilan endpoint secara efisien.
Rincian Kuota & Batas Penggunaan VirusTotal API
VirusTotal menerapkan kebijakan pembatasan akses berdasarkan jenis akun atau kunci API yang digunakan. Berikut adalah tabel komparasi resmi untuk kuota API key publik dan privat.
| Tier API Key | Request per Menit (RPM) | Request per Hari (RPD) | Biaya | Kebutuhan Utama |
|---|---|---|---|---|
| Public API | 4 request | 500 request | Gratis | Hobi, penelitian individu, pengujian skrip kecil |
| Standard Premium API | Bervariasi (50-300+) | Disesuaikan kontrak | Berbayar | Keperluan korporat, SOC, integrasi SIEM/SOAR |
| Enterprise API | Kustom tinggi | Kustom tinggi | Enterprise | Threat intelligence lanjutan, analisis masif |
Aturan Ketat & Larangan Penggunaan (Terms of Use)
Penggunaan VirusTotal Public API diatur oleh ketentuan layanan ketat yang harus dipatuhi oleh setiap pengembang:
- Larangan Komersial: Public API dilarang keras digunakan untuk produk komersial, layanan berbayar, atau monetisasi langsung.
- Atribusi Wajib: Jika hasil pemindaian ditampilkan ke publik, Anda wajib memberikan atribusi yang jelas bahwa data bersumber dari VirusTotal.
- Pembagian Data: Semua file atau URL yang dikirimkan melalui API akan dibagikan kepada komunitas keamanan siber global dan vendor antivirus mitra.
Cara Mengecek Sisa Kuota API Key
Anda dapat memantau penggunaan kuota API secara programatik dengan mengakses endpoint akun pengguna di VirusTotal v3 API. Berikut adalah contoh kode menggunakan Python untuk memeriksa status kuota dan informasi akun Anda.
import requests
# Ganti dengan API key valid Anda
API_KEY = "MASUKKAN_API_KEY_ANDA_DISINI"
HEADER = {"x-apikey": API_KEY}
url = "https://www.virustotal.com/api/v3/users/YOUR_USERNAME"
response = requests.get(url, headers=HEADER)
if response.status_code == 200:
data = response.json()
print("Informasi Kuota Berhasil Diambil:")
print(data)
else:
print(f"Gagal mengambil data. Status Code: {response.status_code}")
Tips Mengatasi Error 429 (Too Many Requests)
Jika aplikasi Anda sering menghadapi kendala pembatasan kuota saat menggunakan Public API, terapkan strategi teknis berikut:
- Implementasikan Jeda Waktu (Delay): Tambahkan fungsi tidur (sleep) minimal 15 detik di antara setiap pemanggilan request agar tidak melewati batas 4 RPM.
- Manfaatkan Caching: Simpan hasil pemindaian (hash SHA-256) ke dalam database lokal sebelum melakukan permintaan baru ke server VirusTotal. Jika file yang sama diuji kembali dalam kurun waktu 24 jam, gunakan data cache lokal.
- Upgrade ke Premium: Jika volume analisis Anda melebihi 500 file per hari, beralihlah ke paket berbayar untuk menghindari gangguan operasional.