Zararlı Bağlantı Kontrol API
USOM zararlı bağlantı listesinde tek istekle sorgu: oltalama, sahte banka siteleri, zararlı yazılım.
/v1/guvenlik/zararli-kontrol?adres= bir alan adını, URL'yi ya da IP adresini yaklaşık 500 bin kayıtlık USOM listesinde arar. Alan adının kendisi ya da üst alan adı listedeyse (giris.ornek-banka.shop ← ornek-banka.shop), URL listedeki bir bağlantıyla başlıyorsa ya da IP birebir eşleşiyorsa zararli: true döner; eşleşen kaydın kategorisi (oltalama, bankacılık oltalaması, zararlı yazılım), kritiklik seviyesi ve eklenme tarihiyle. Aynı alan adı altındaki diğer zararlı bağlantılar ilgili alanında bilgi olarak verilir.
/v1/guvenlik/zararli/son listeye son eklenen adresleri türe, kategoriye ve güne göre süzer; /v1/guvenlik/bildirimler Siber Güvenlik Başkanlığı'nın TR-26-xxxx güvenlik bildirimlerini özet, etiket ve CVE numaralarıyla döndürür. Liste 30 dakikada bir, tekil sorgular kaynaktan anlık (bir saat önbellekli) gelir.
Hızlı başlangıç
Anahtarınızı X-API-Key başlığında gönderin (ücretsiz anahtar al).
Anahtarı tarayıcı koduna koymayın; sunucunuzdan çağırıp sonucu önbelleğe alın.
<?php
$ch = curl_init('https://api.veriapi.pro/v1/guvenlik/zararli/son?tur=alan_adi&kategori=BP&limit=5');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
CURLOPT_HTTPHEADER => ['X-API-Key: va_ANAHTARINIZ'],
]);
$yanit = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($yanit['veri']);
const yanit = await fetch("https://api.veriapi.pro/v1/guvenlik/zararli/son?tur=alan_adi&kategori=BP&limit=5", {
headers: { "X-API-Key": "va_ANAHTARINIZ" },
});
const { veri, kaynak } = await yanit.json();
console.log(veri);
import requests
r = requests.get("https://api.veriapi.pro/v1/guvenlik/zararli/son?tur=alan_adi&kategori=BP&limit=5",
headers={"X-API-Key": "va_ANAHTARINIZ"}, timeout=10)
print(r.json()["veri"])
curl -H "X-API-Key: va_ANAHTARINIZ" \ "https://api.veriapi.pro/v1/guvenlik/zararli/son?tur=alan_adi&kategori=BP&limit=5"
Örnek yanıt
GET https://api.veriapi.pro/v1/guvenlik/zararli/son?tur=alan_adi&kategori=BP&limit=5 — gerçek veriyle; listeler kısaltıldı.
{
"veri": {
"liste_toplami": 500468,
"adet": 5,
"kayitlar": [
{
"id": 1187086,
"adres": "turkcelpasaj.store",
"tur": "alan_adi",
"kategori": "BP",
"kategori_ad": "Bankacılık - Oltalama",
"kritiklik": 4,
"tarih": "2026-11-03T06:19:11"
},
{
"id": 1187080,
"adres": "mhrsrandevualtr.sbs",
"tur": "alan_adi",
"kategori": "BP",
"kategori_ad": "Bankacılık - Oltalama",
"kritiklik": 4,
"tarih": "2026-11-03T04:59:11"
},
{
"id": 1187072,
"adres": "maliyevezneformu.org",
"tur": "alan_adi",
"kategori": "BP",
"kategori_ad": "Bankacılık - Oltalama",
"kritiklik": 4,
"tarih": "2026-11-03T02:59:11"
},
"… 2 öğe daha"
],
"kategoriler": {
"PH": "Oltalama",
"MD": "Zararlı Yazılım Barındıran / Yayan Alan Adı",
"MI": "Zararlı Yazılım Barındıran / Yayan IP",
"MU": "Zararlı Yazılım Barındıran / Yayan URL",
"MC": "Zararlı Yazılım - Komuta Kontrol Merkezi",
"BP": "Bankacılık - Oltalama",
"CA": "Siber Saldırı (Port Tarama, Kaba Kuvvet vb.)"
},
"not": "Kümede kaynağın en yeni 1000 kaydı tutulur; tekil kontrol için /v1/guvenlik/zararli-kontrol."
},
"kaynak": [
{
"kod": "usom",
"ad": "T.C. Siber Güvenlik Başkanlığı (USOM) zararlı bağlantılar",
"lisans": "Kamu kaynağı; entegrasyon amacıyla açık API (kaynak gösterilerek)",
"atif": "Kaynak: T.C. Siber Güvenlik Başkanlığı — USOM (https://siberguvenlik.gov.tr/zararli-baglantilar)",
"url": "https://siberguvenlik.gov.tr/zararli-baglantilar"
}
],
"guncelleme": "2026-11-03T10:42:03",
"bayat": false
}
Uçlar ve parametreler
GET /v1/guvenlik/zararli-kontrol
ücretsiz pakette
2 birim
Alan adı / URL / IP USOM zararlı bağlantı listesinde mi?
| Parametre | Tür | Açıklama |
|---|---|---|
| adres* | metin | Alan adı (ornek.com), URL ya da IP adresi |
GET /v1/guvenlik/zararli/son
ücretsiz pakette
1 birim
Son eklenen zararlı adresler: oltalama, zararlı yazılım, komuta kontrol
| Parametre | Tür | Açıklama |
|---|---|---|
| tur | metin | |
| kategori | metin | PH, BP, MD, MI, MU, MC |
| gun | tam sayı | Son kaç gün |
| limit | tam sayı | varsayılan: 100 |
GET /v1/guvenlik/bildirimler
ücretsiz pakette
1 birim
Siber Güvenlik Başkanlığı güvenlik bildirimleri ve CVE'ler
| Parametre | Tür | Açıklama |
|---|---|---|
| etiket | metin | Ürün / etiket (ör. WordPress) |
| limit | tam sayı | varsayılan: 20 |
Konum alan uçlarda konum (slug), il + ilce (ad, slug ya da plaka) ya da enlem + boylam kullanılabilir.
Tüm parametreler: OpenAPI belgesi.
Nerelerde kullanılır?
- ✓Yorum, forum ve mesaj formlarında paylaşılan bağlantıyı yayımlamadan önce denetleme
- ✓Haber sitesinde "bu siteye girmeyin" dolandırıcılık haberleri ve son eklenen sahte siteler kutusu
- ✓Kurum içi URL filtresi, e-posta güvenlik ağ geçidi ve SIEM entegrasyonu
- ✓Yazılım ekipleri için kullandıkları ürünlere ait güvenlik bildirimi takibi
Kaynak ve lisans
- T.C. Siber Güvenlik Başkanlığı (USOM) zararlı bağlantılar · Kamu kaynağı; entegrasyon amacıyla açık API (kaynak gösterilerek) · kaynak
Atıf: Kaynak: T.C. Siber Güvenlik Başkanlığı — USOM (https://siberguvenlik.gov.tr/zararli-baglantilar)
Her yanıtın kaynak alanı bu bilgiyi taşır; veriyi gösterdiğiniz yerde atıf metnini yazın.
Sık sorulan sorular
Zararlı bağlantı API'si ücretsiz mi?
Evet; üç uç da her pakette açıktır. Tekil kontrol istek başına 2 birim, liste ve bildirimler 1 birimdir.
Listede yoksa site güvenli mi?
Hayır. Liste yalnızca Siber Güvenlik Başkanlığı'nın tespit ettiği ya da ihbarla doğruladığı adresleri içerir; yeni açılan sahte siteler henüz listede olmayabilir.
Türkçe karakterli alan adları?
Desteklenir: ödeme-türkiye.shop gibi adresler otomatik olarak punycode'a (xn--…) çevrilip aranır.
Yanıtta kaynak göstermem gerekir mi?
Evet; veri T.C. Siber Güvenlik Başkanlığı'na (USOM) aittir, kaynak alanındaki atıf metni gösterildiği yerde yazılmalıdır.
Bu sayfa şu aramalar için de: usom api · usom zararlı bağlantılar json · oltalama sitesi sorgulama · phishing domain kontrol api · sahte site sorgulama · siberguvenlik.gov.tr api