Skip to main content

​
Analytics

Historical metrics and timelines for your domains. For the Traffic Risk summary on Overview, see Traffic Score. API base: https://account.shieldlabs.ai/api

​
Metrics available

MetricDescription
Total requestsFingerprint checks in period
Unique visitorsDistinct VisitorIDs
Unique devicesDistinct DeviceIDs
Score distributionSessions by risk band
TimelineScore distribution by time buckets

​
Score distribution

The same bands power Traffic Score on Overview:
CategoryScore rangeLabel
Clean0–9Green
Low risk10–29Yellow
Medium risk30–59Orange
High risk60–99Red
Bot / Ban100+Dark red

​
API access

# Score distribution for a domain
GET https://account.shieldlabs.ai/api/metric/statistic/score/{site_id}

# Unique visitor count
GET https://account.shieldlabs.ai/api/metric/count/unique/{site_id}/visitor_id

# Score timeline (4h buckets)
GET https://account.shieldlabs.ai/api/metric/statistic/score/timeline/day/4h/{site_id}
For Overview Traffic Risk (average score + categories + trends), use Traffic Score API: 
GET https://account.shieldlabs.ai/api/overview/traffic-score?projectId={domain_uuid}
All endpoints require Authorization: Bearer <token>.