Brend tapıntılarını siyahıla

Brendinizi təqlid edən domenlər, fişinq səhifələri, tətbiqlər və sosial media hesabları; bal, əhəmiyyət və işarələri ilə.

GET/v1/brand/findings

GETBrend tapıntılarını siyahıla

curl -X GET "https://api.darkradar.com/api/public/v1/brand/findings" \
  -H "x-api-key: $DARKRADAR_API_KEY"

Cavab

Uğurlu

{
  "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
  }
}

Giriş icazəsi

Əhatəbrand:read

Plan hüququintel_customer

Sorğu parametrləri

Sahələr	Dəyərlər
`brandId` · string · istəyə bağlı	Brendə görə süz · Nümunə: `64b1f0c2a9e4d21f8c3b9a41`
`tur` · string · istəyə bağlı	Tapıntı növü · Dəyərlər: domain, phishing, app, social · Nümunə: `domain`
`durum` · string · istəyə bağlı	Status (`open` = bağlanmamış olanlar) · Dəyərlər: open, new, acknowledged, investigating, resolved, false_positive · Nümunə: `open`
`onem` · string · istəyə bağlı	Əhəmiyyət · Dəyərlər: low, medium, high, critical · Nümunə: `high`
`q` · string · istəyə bağlı	Dəyərdə mətn axtarışı · Nümunə: `darkradar`
`sirala` · string · istəyə bağlı	Sıralama · Dəyərlər: puan, sonGorulme, ilkGorulme · Nümunə: `puan`
`sayfa` · integer · istəyə bağlı	Səhifə nömrəsi (1-dən başlayır) · Nümunə: `1`
`boyut` · integer · istəyə bağlı	Səhifə başına qeyd (ən çox 200) · Nümunə: `50`

Cavablar

200Uğurlu

400Sorğu etibarsızdır (pozuq kimlik, çatışmayan və ya səhv sahə)

401Açar yoxdur, etibarsızdır, müddəti bitib və ya ləğv edilib

403Əhatə kifayət etmir, planda API girişi yoxdur və ya məhsul açıq deyil

404Qeyd yoxdur və ya bu açarın şirkətinə aid deyil

408Sorğu maksimum cavab müddətini aşdı

429Sürət həddi aşıldı; bir dəqiqə sonra yenidən yoxlayın

Cavab limitləri

Sürət limiti15 dəqiqədə 500 sorğu · IP başına

{ "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 } }