Skip to main content
GET
/
sessions
/
average
Get Average Session Length
curl --request GET \
  --url https://ebn.telemetree.io/public-api/sessions/average \
  --header 'x-api-key: <api-key>'
{
  "data": {
    "filters": [
      {
        "op": "is",
        "prop": "country",
        "values": [
          "United States"
        ]
      }
    ],
    "series": [
      [
        22.7143,
        8.4,
        2.125
      ]
    ],
    "seriesMeta": [
      {
        "segmentIndex": 0
      }
    ],
    "xValues": [
      "2024-08-01",
      "2024-08-02",
      "2024-08-03"
    ]
  }
}

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

Average session length data

Example:
{
  "filters": [
    {
      "op": "is",
      "prop": "country",
      "values": ["United States"]
    }
  ],
  "series": [[22.7143, 8.4, 2.125]],
  "seriesMeta": [{ "segmentIndex": 0 }],
  "xValues": ["2024-08-01", "2024-08-02", "2024-08-03"]
}