URL Statistics

curl -X GET "https://<hostname>/ekranapi/statistics/geturl?start=2021-09-01&end=2021-09-02" \
  -H "ApiKey: xJ)tsCNcpj)l+]}(@_|lt!t………"

[
  {
    "data": [
      {
        "duration": "00:02:50.3010000",
        "key": "help.com"
      },
      {
        "duration": "00:02:50.3010000",
        "key": "new.net"
      }
    ],
    "sessionId": 134,
    "timeOfDay": "2021-09-01T17:00:00+03:00"
  },
  {
    "data": [
      {
        "duration": "01:02:50.3010000",
        "key": "test.com"
      },
      {
        "duration": "00:01:00.3010000",
        "key": "blog"
      }
    ],
    "sessionId": 431,
    "timeOfDay": "2022-02-01T17:00:00+07:00"
  }
]

Returns time spent on each URL broken down by hour and session — useful for “which sites did the user visit during work hours?” style analytics. Same structural shape as Application statistics, but the key field contains a URL instead of an application name.

GET https://<hostname>/ekranapi/statistics/geturl

Authentication

string

required

Your Active API Key from the Management Tool.

Query parameters

string

Sessions that were started or finished after this time are included.Accepted formats: 2021-04-01, 2021-04-01T12:00, 2021-04-01T12:00:00.

string

Sessions that were started or finished before this time are included.

If both start and end are omitted, statistics for all sessions in the database are returned. See Time parameter conventions for full rules.

Response (200 OK)

array

Array of per-URL time records for this (session, hour):

Show Per-URL record

timespan

Total time spent on this URL during this hour of this session.

string

The URL of the website visited (e.g. help.com, new.net).

int32

The ID of the session this block belongs to.

date-time

The hour of the day.

Example

curl -X GET "https://<hostname>/ekranapi/statistics/geturl?start=2021-09-01&end=2021-09-02" \
  -H "ApiKey: xJ)tsCNcpj)l+]}(@_|lt!t………"

[
  {
    "data": [
      {
        "duration": "00:02:50.3010000",
        "key": "help.com"
      },
      {
        "duration": "00:02:50.3010000",
        "key": "new.net"
      }
    ],
    "sessionId": 134,
    "timeOfDay": "2021-09-01T17:00:00+03:00"
  },
  {
    "data": [
      {
        "duration": "01:02:50.3010000",
        "key": "test.com"
      },
      {
        "duration": "00:01:00.3010000",
        "key": "blog"
      }
    ],
    "sessionId": 431,
    "timeOfDay": "2022-02-01T17:00:00+07:00"
  }
]

URL monitoring must be enabled on the Client for it to record URL data — see user activity recording parameters. Sessions without URL monitoring enabled won’t return URL records here.

Errors

See Status codes. Common errors:

400 Bad Request — invalid start or end format.
403 Forbidden — Data Connector not registered.

Application statistics

Same shape, but for applications instead of URLs.

User productivity

Aggregate active time per user per hour.

List sessions with productivity

Session-level duration and productivity.

API reference

Base URL, authentication, status codes.

Overview

Application Credentials Broker

Data Connector API

SSO & LDAP

SIEM & Ticketing systems

URL Statistics

Authentication

Query parameters

Response (200 OK)

Example

Errors

Application statistics

User productivity

List sessions with productivity

API reference

​Authentication

​Query parameters

​Response (200 OK)

​Example

​Errors

​Related

Application statistics

User productivity

List sessions with productivity

API reference

Authentication

Query parameters

Response (200 OK)

Example

Errors

Related