Portal

Updates

API Reference

x-api-key

Telemetree Docs

Dashboard

Support

Send Event To Telemetree Pipeline

Location

Message

Error Type

ValidationError

EncryptedEventPayload

x api key

x project id

HTTPValidationError

Here you will find all the relevant resources to set up analytics for your Telegram Mini App!

Overview

Connect Telemetree and start tracking your events!

Quickstart

Your step-by-step guide on setting up your dashboard

Everything you need to know about setting up Telemetree Ads SDK and monetizing your games

Setup Telemetree Ads

Learn the ropes of our monetization dashboard

Monetization Dashboard

Changelog

This page contains all the relevant information for the pricing of Telemetree services

Pricing

Learn more about the team behind Telemetree

About Us

Learn the most advanced techniques from the best in the industry

Learning Center

React

Javascript

Python

.NET

Useful links

Learn more about our data protection policies

Data Protection

Below is the current version of our Terms Of Service.

Terms of Service

Common issues

**Description:** Retrieves new and active users count based on the specified mode, start and end dates.

**Note:** If you struggle to figure out the segments, please check out the helper function - `get_segment_definition`.

**Parameters:**
- `api_key`: API key (https://app.telemetree.io/settings/project)
- `group_by`: List of fields to group by
- `period`: The start and end dates
- `filters`: List of filters in Amplitude-like format

**Returns:**
- `UserCountResponse`: The transformed user count data.

**Raises:**
- `HTTPException`: If an error occurs during the retrieval process.

Get New And Active Users Count

Get User Segmentation

**Header**
- `x-api-key`: Your API Key (Dashboard->Settings)

**Returns:**
- `JSONResponse`: The response containing the realtime users data.

**Raises:**
- `HTTPException`: If an error occurs while fetching or transforming the data.

Get Realtime Users

**Description:** Retrieves the user info based on the specified user ID.

**Parameters:**
- `user_id`: User ID (Telegram ID)

**Header**
- `x-api-key`: Your API Key (Dashboard->Settings)

**Returns:**
- `FilteredUser`: The user info.

**Raises:**
- `HTTPException`: If an error occurs during the retrieval process.

Get User Info

**Description:** Retrieves the segment definition based on the specified properties, operator, and values.

**Parameters:**
- `props`: The property
- `op`: The operator
- `values`: The values

**Returns:**
- `str`: The segment definition.

Get Segment Definition

**Description:** Retrieves session length distribution based on the specified start and end dates.

**Parameters:**
- `period`: The start and end dates
- `filters`: List of filters in Amplitude-like format

**Header**
- `x-api-key`: Your API Key (Dashboard->Settings)

**Returns:**
- `SessionLengthResponse`: The transformed session length distribution data.

**Raises:**
- `HTTPException`: If an error occurs during the retrieval process.

Get Session Length Distribution

**Description:** Retrieves average session length based on the specified start and end dates.

**Parameters:**
- `period`: The start and end dates

**Header**
- `x-api-key`: Your API Key (Dashboard->Settings)

**Returns:**
- `AverageSessionLengthResponse`: The transformed average session length data.

**Raises:**
- `HTTPException`: If an error occurs during the retrieval process.

Get Average Session Length

**Description:** Retrieves average number of sessions per user based on the specified start and end dates.

**Parameters:**
- `period`: The start and end dates

**Header**
- `x-api-key`: Your API Key (Dashboard->Settings)

**Returns:**
- `AverageSessionsPerUserResponse`: The transformed average number of sessions per user data.

**Raises:**
- `HTTPException`: If an error occurs during the retrieval process.

Get Average Number Of Sessions Per User

**Description:** Retrieves events segmentation based on the specified start and end dates.

**Parameters:**
- `period`: The start and end dates
- event (str): The event
- `mode`: The mode
- `filters`: List of filters in Amplitude-like format
- `group_by`: The group by

**Header**
- `x-api-key`: Your API Key (Dashboard->Settings)

**Returns:**
- `EventSegmentationResponse`: The transformed events segmentation data.

**Raises:**
- `HTTPException`: If an error occurs during the retrieval process.

Get Events Segmentation

**Parameters:**
- `period`: The start and end dates

**Header**
- `x-api-key`: Your API Key (Dashboard->Settings)

**Returns:**
- `EventListModel`: The list of events.

Most Popular Events For The Selected Period

**Description:** Retrieves funnel data based on the specified events, start and end dates,
and filters.

**Parameters:**
- `events`: List of events
- `filters`: List of filters in Amplitude-like format
- `group_by`: List of fields to group by
- `period`: The start and end dates

**Header**
- `x-api-key`: Your API Key (Dashboard->Settings)

**Returns:**
- `FunnelAnalysisResponse`: The transformed funnel data.

**Raises:**
- `HTTPException`: If an error occurs during the retrieval process.

Get Funnel Analysis

**Description:** Retrieves retention analysis based on the specified start and end dates.

**Parameters:**
- `period`: The start and end dates

**Header**
- `x-api-key`: Your API Key (Dashboard->Settings)

**Returns:**
- `RetentionAnalysisResponse`: The transformed retention analysis data.

**Raises:**
- `HTTPException`: If an error occurs during the retrieval process.

Get Retention Analysis

**Description:** Retrieves the monthly active users based on the specified limit and offset.

**Parameters:**
- `limit`: The number of items to return
- `offset`: The number of items to skip

**Header**
- `x-api-key`: Your API Key (Dashboard->Settings)

**Returns:**
- `MonthlyActiveUsersResponse`: The response containing the monthly active users.

**Raises:**
- `HTTPException`: If an error occurs during the process.

Monthly Active Users

**Description:** Retrieves the monthly active users overview.

**Parameters:**
- `limit`: The number of items to return
- `offset`: The number of items to skip

**Header**
- `x-api-key`: Your API Key (Dashboard->Settings)

**Returns:**
- `AppMonthlyActiveUsersResponse`: The response containing the monthly active users.

Monthly Active Users Overview

**Description:** Retrieves the monthly active users based on the specified handle.

**Parameters:**
- `handle`: The handle of the application (work both @handle and handle)

**Header**
- `x-api-key`: Your API Key (Dashboard->Settings)

User API

User API (Utils)

Events API

Funnels API

Retention API

Monthly Active Users API

Telemetree Data Pipeline

Send Event To Telemetree Pipeline

Authorizations

Body

Response