Skip to main content
GET
https://app.usehardal.com
/
api
/
websites
/
{websiteId}
/
active
Active Users API
curl --request GET \
  --url https://app.usehardal.com/api/websites/{websiteId}/active \
  --header 'Authorization: Bearer <token>'
{
  "count": 5,
  "visitors": [
    {
      "id": "user_123",
      "sessionId": "session_abc123",
      "page": "/dashboard",
      "title": "Dashboard - My App",
      "referrer": "https://google.com",
      "browser": "Chrome",
      "os": "Windows",
      "device": "Desktop",
      "country": "United States",
      "duration": 120,
      "lastSeen": "2024-01-15T10:30:00Z"
    }
  ],
  "pages": [
    {
      "path": "/dashboard",
      "title": "Dashboard",
      "count": 3
    },
    {
      "path": "/analytics",
      "title": "Analytics",
      "count": 2
    }
  ],
  "referrers": [
    {
      "domain": "google.com",
      "count": 2
    },
    {
      "domain": "twitter.com",
      "count": 1
    }
  ],
  "devices": [
    {
      "name": "Desktop",
      "count": 3
    },
    {
      "name": "Mobile",
      "count": 2
    }
  ],
  "countries": [
    {
      "name": "United States",
      "count": 3
    },
    {
      "name": "Canada",
      "count": 2
    }
  ]
}
Get real-time visibility into who’s currently browsing your website. Track active visitors, see what pages they’re viewing, and monitor live traffic patterns.
​
websiteId
string
required
Your website signal ID
​
minutes
integer
default:"5"
Time window in minutes to look back for active visitors
​
targetSignalId
string
default:"websiteId"
Target signal ID for analytics data (use inherited signal ID if different from websiteId, otherwise same as websiteId)
​
isHybrid
boolean
default:"false"
Whether this is a hybrid/self-hosted signal
{
  "count": 5,
  "visitors": [
    {
      "id": "user_123",
      "sessionId": "session_abc123",
      "page": "/dashboard",
      "title": "Dashboard - My App",
      "referrer": "https://google.com",
      "browser": "Chrome",
      "os": "Windows",
      "device": "Desktop",
      "country": "United States",
      "duration": 120,
      "lastSeen": "2024-01-15T10:30:00Z"
    }
  ],
  "pages": [
    {
      "path": "/dashboard",
      "title": "Dashboard",
      "count": 3
    },
    {
      "path": "/analytics",
      "title": "Analytics",
      "count": 2
    }
  ],
  "referrers": [
    {
      "domain": "google.com",
      "count": 2
    },
    {
      "domain": "twitter.com",
      "count": 1
    }
  ],
  "devices": [
    {
      "name": "Desktop",
      "count": 3
    },
    {
      "name": "Mobile",
      "count": 2
    }
  ],
  "countries": [
    {
      "name": "United States",
      "count": 3
    },
    {
      "name": "Canada",
      "count": 2
    }
  ]
}