Skip to content
nebtynebtynebty Docs

Get brand statistics

GET
/core/api/brands/{id}/stats/
curl --request GET \
  --url https://app.nebty.de/core/api/brands/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/stats/ \
  --header 'Authorization: <Authorization>'

Returns aggregate figures for one brand: domain count, scan count, date of the latest scan, high-risk count, average risk score, risk_distribution, domain_risk_distribution (domain buckets that sum to domain_count; prefer it over the legacy risk_distribution), verdict_stats (red, amber, green, unknown counts, the same values verdict_filter accepts on the domain list) and http_status_stats.

visual_match_stats is deprecated; use verdict_stats. The figures are cached for up to five minutes, so a newly found domain can take that long to show up here.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string format: uuid

UUID of the brand, as returned in the id field of the brand list.

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json

Serializer for comprehensive brand statistics.

object
domain_risk_distribution

Domain-based buckets summing to domain_count, including zero risk and unscanned. Prefer these over legacy risk_distribution, which counts scan rows at scores 1+.

object
key
additional properties
integer
domain_count
required
integer
scan_count
required
integer
latest_scan_date
required
string format: date-time
nullable
high_risk_count
required
integer
average_risk_score
required
number format: double
risk_distribution
required

Risk distribution with low_risk_count, medium_risk_count, high_risk_count

object
key
additional properties
integer
visual_match_stats
required

Deprecated — use verdict_stats. Visual match statistics with visual_matches_found, no_visual_matches, unknown_visual_matches

object
key
additional properties
integer
verdict_stats
required

Verdict statistics with red, amber, green, unknown counts. Matches the values accepted by the domains list endpoint’s verdict_filter query parameter.

object
key
additional properties
integer
http_status_stats
required

HTTP status statistics with live_domains, error_domains, unknown_status

object
key
additional properties
integer
Examplegenerated
{
  "domain_risk_distribution": {
    "additionalProperty": 1
  },
  "domain_count": 1,
  "scan_count": 1,
  "latest_scan_date": "2026-04-15T12:00:00Z",
  "high_risk_count": 1,
  "average_risk_score": 1,
  "risk_distribution": {
    "additionalProperty": 1
  },
  "visual_match_stats": {
    "additionalProperty": 1
  },
  "verdict_stats": {
    "additionalProperty": 1
  },
  "http_status_stats": {
    "additionalProperty": 1
  }
}

401

Section titled “401”

The API key is missing, invalid, revoked or belongs to an inactive user.

Media typeapplication/json
object
detail
required
string
Examplegenerated
{
  "detail": "example"
}

404

Section titled “404”

The requested page or record does not exist or cannot be accessed.

Media typeapplication/json
object
detail
required
string
Examplegenerated
{
  "detail": "example"
}

429

Section titled “429”

Too many requests or failed authentication attempts. Try again later.

Media typeapplication/json
object
detail
required
string
Examplegenerated
{
  "detail": "example"
}