API belgeleri

Marka bulgularını listele

Markanızı taklit eden alan adları, oltalama sayfaları, uygulamalar ve sosyal medya hesapları; puan, önem ve işaretleriyle.

GET/v1/brand/findings
GETMarka bulgularını listele
curl -X GET "https://api.darkradar.com/api/public/v1/brand/findings" \
  -H "x-api-key: $DARKRADAR_API_KEY"
Yanıt

Başarılı

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "64b1f0c2a9e4d21f8c3b9a40",
        "brandId": "64b1f0c2a9e4d21f8c3b9a41",
        "tur": "domain",
        "deger": "darkradar-giris.com",
        "durum": "new",
        "onem": "high",
        "puan": 78,
        "isaretler": [
          {
            "kod": "ad-benzer",
            "agirlik": 30,
            "aciklama": "Marka adına çok benziyor"
          }
        ],
        "kanit": {
          "kayit": {
            "kayitKurulusu": "Example Registrar",
            "kayitTarihi": "2026-09-28T00:00:00.000Z"
          }
        },
        "kaynaklar": [
          {
            "kod": "czds",
            "ilkGorulme": "2026-09-29T02:00:00.000Z",
            "sonGorulme": "2026-10-03T02:00:00.000Z"
          }
        ],
        "ilkGorulme": "2026-09-29T02:00:00.000Z",
        "sonGorulme": "2026-10-03T02:00:00.000Z",
        "sonKontrol": "2026-10-03T03:25:00.000Z",
        "canli": true,
        "takedownId": null,
        "executiveId": null,
        "not": null,
        "statusEvents": []
      }
    ],
    "total": 1
  }
}

Yetki

Kapsambrand:read
Plan yetkisiintel_customer

Sorgu parametreleri

AlanlarDeğerler
brandId · string · isteğe bağlıMarkaya göre süz · Örnek: 64b1f0c2a9e4d21f8c3b9a41
tur · string · isteğe bağlıBulgu türü · Değerler: domain, phishing, app, social · Örnek: domain
durum · string · isteğe bağlıDurum (open = kapanmamış olanlar) · Değerler: open, new, acknowledged, investigating, resolved, false_positive · Örnek: open
onem · string · isteğe bağlıÖnem · Değerler: low, medium, high, critical · Örnek: high
q · string · isteğe bağlıDeğerde metin araması · Örnek: darkradar
sirala · string · isteğe bağlıSıralama · Değerler: puan, sonGorulme, ilkGorulme · Örnek: puan
sayfa · integer · isteğe bağlıSayfa numarası (1’den başlar) · Örnek: 1
boyut · integer · isteğe bağlıSayfa başına kayıt (en çok 200) · Örnek: 50

Yanıtlar

200Başarılı
400İstek geçersiz (bozuk kimlik, eksik ya da hatalı alan)
401Anahtar yok, geçersiz, süresi dolmuş ya da iptal edilmiş
403Kapsam yetersiz, planda API erişimi yok ya da ürün açık değil
404Kayıt yok ya da bu anahtarın firmasına ait değil
408İstek azami yanıt süresini aştı
429Hız sınırı aşıldı; bir dakika sonra tekrar deneyin

Yanıt sınırları

Hız sınırı15 dakikada 500 istek · IP başına

Bu sayfa işinize yaradı mı?