Skip to main content
GET
/
sessions
/
length
Get Session Length Distribution
curl --request GET \
  --url https://ebn.telemetree.io/public-api/sessions/length \
  --header 'x-api-key: <api-key>'
{
  "data": {
    "filters": [
      {
        "op": "is",
        "prop": "country",
        "values": [
          "United States"
        ]
      }
    ],
    "series": [
      [
        90,
        8,
        26,
        10,
        3
      ]
    ],
    "xValues": [
      "0-5 seconds",
      "5-10 seconds",
      "11-60 seconds",
      "1-5 minutes",
      "5+ minutes"
    ]
  }
}

Authorizations

​
x-api-key
string
header
required

Your API Key (Dashboard->Settings)

Query Parameters

​
start
string
required

Start date in YYYYMMDD format

​
end
string
required

End date in YYYYMMDD format

​
segments
string[] | null

Segments in Amplitude-like format. Example used: [{"prop":"country","op":"is","values":["United States"]}]

Response

Successful Response

​
data
object
required

Session length data

Example:
{
  "filters": [
    {
      "op": "is",
      "prop": "country",
      "values": ["United States"]
    }
  ],
  "series": [[90, 8, 26, 10, 3]],
  "xValues": [
    "0-5 seconds",
    "5-10 seconds",
    "11-60 seconds",
    "1-5 minutes",
    "5+ minutes"
  ]
}