Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

Quick StartWhat is Saasco?

Analytics

getList UsersgetGet UsergetCurrent UserspostLatest IdentifiesdelDelete User

CRM

Email Marketing

Knowledge

Support

Projects

Users

Current Users

Counts visitors seen in the last minutes minutes: the live-visitors number. Optional filters narrow the count to a segment (country, device, browser, UTM tags). Returns a single row holding the visit count.

GET
/projects/{projectId}/analytics/current-users

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project to count visitors for.

Query Parameters

minutesrequirednumber

Size of the look-back window in minutes. A visitor counts as present if they were active within this many minutes of now.

locationstring

Only count visitors from this country name.

devicestring

Only count visitors on this device type, e.g. mobile.

browserstring

Only count visitors on this browser, e.g. Chrome.

referrerstring

Only count visitors with this exact referrer URL.

utmSourcestring

Only count visitors tagged with this utm_source.

utmMediumstring

Only count visitors tagged with this utm_medium.

utmCampaignstring

Only count visitors tagged with this utm_campaign.

utmTermstring

Only count visitors tagged with this utm_term.

utmContentstring

Only count visitors tagged with this utm_content.

utmAdIdstring

Only count visitors attributed to this ad ID.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://www.saasco.com/api/v2/projects/string/analytics/current-users?minutes=0"
{
  "meta": [
    {
      "name": "string",
      "type": "string"
    }
  ],
  "rows": 0,
  "statistics": {
    "bytes_read": 0,
    "elapsed": 0,
    "rows_read": 0
  },
  "usage": {
    "cost": 0,
    "duration": 0,
    "metricCount": 0
  },
  "data": [
    {
      "visits": 0
    }
  ]
}
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Get User

Fetches the most recent identify record for one user, returning the full property bag last known for them: reserved fields like `email` and `name`, Saasco's `$`-prefixed system properties (geo, device, referrer, subscription state), and any custom properties you have sent.

Latest Identifies

Returns the property bags of the 5 most recently seen identified users. Intended as a sample for previewing what identify data is arriving. For a full list use List Users, and for one specific user use Get User.