> ## Documentation Index
> Fetch the complete documentation index at: https://www.tella.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics

> Read plays, watch time, retention, geography, and referrers for a video or the whole workspace.

Read viewing analytics for a single video or across the workspace. Metrics count plays (a viewer starting the video), unique viewer sessions, watch time, and how much of the video was watched, broken down by day, position in the video, country, referring domain, and UTM parameters. Dates are whole UTC days; omit both to get all time.

## get\_video\_analytics

Viewing analytics for one video: summary, plays per day, retention per one-percent slice, geography, referrers, UTM traffic sources, and call-to-action clicks. Available for videos you created, collaborate on, or that are shared with your workspace.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>

<ParamField path="startDate" type="string">
  First day of the range, inclusive, as `YYYY-MM-DD` in UTC
</ParamField>

<ParamField path="endDate" type="string">
  Last day of the range, inclusive, as `YYYY-MM-DD` in UTC
</ParamField>

<ParamField path="timezone" type="string">
  IANA time zone used to bucket `viewsOverTime` into days (default: `UTC`)
</ParamField>

## get\_workspace\_analytics

Viewing analytics aggregated across videos: by default every video shared with the workspace, or with `scope: "mine"` only the videos you created. Returns the summary, plays per day, retention, geography and referrer breakdowns, plus `topVideos` ranked by plays. Only `topVideos` is paginated — pass `pagination.nextCursor` as `cursor` for the next page.

<ParamField path="scope" type="enum<string>">
  `workspace` (default) or `mine`
</ParamField>

<ParamField path="startDate" type="string">
  First day of the range, inclusive, as `YYYY-MM-DD` in UTC
</ParamField>

<ParamField path="endDate" type="string">
  Last day of the range, inclusive, as `YYYY-MM-DD` in UTC
</ParamField>

<ParamField path="timezone" type="string">
  IANA time zone used to bucket `viewsOverTime` into days (default: `UTC`)
</ParamField>

<ParamField path="limit" type="integer">
  Top videos per page (1-100, default: 20)
</ParamField>

<ParamField path="cursor" type="string">
  Pagination cursor from the previous response
</ParamField>


## Related topics

- [Video analytics](/docs/help/sharing/analytics.md)
- [Get video analytics](/docs/api-reference/analytics/get-video-analytics.md)
- [Get workspace analytics](/docs/api-reference/analytics/get-workspace-analytics.md)
- [Refer and earn](/docs/help/referrals/refer-and-earn.md)
- [Product Changelog](/docs/changelog.md)