Analytics

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. Includes the same summary, plays per day, retention, geography and referrer breakdowns as a single video, plus the videos ranked by plays. Only topVideos is paginated; pass pagination.nextCursor as cursor for the next page. Dates are whole UTC days; omit both for all time.

get/v1/analytics

Request

  • Base URL: https://api.tella.com
  • URL: https://api.tella.com/v1/analytics
  • Auth: HTTP bearer

Query parameters

startDatestring

First day of the range, inclusive, as YYYY-MM-DD in UTC. Omit to start from the first recorded view.

Example:2026-01-01
endDatestring

Last day of the range, inclusive, as YYYY-MM-DD in UTC. Omit to run through today.

Example:2026-01-01
timezonestring

IANA time zone used to bucket viewsOverTime into days (default: UTC)

Example:America/New_York
scope'workspace' | 'mine'

workspace: every video shared with the workspace. mine: videos the authenticated user created.

Example:workspace

Which videos to aggregate (default: workspace)

limitinteger

Top videos per page (default: 20, max: 100)

Example:20
cursorstring

Opaque cursor for the next page of top videos, from the previous response's pagination.nextCursor

Response

OK

endDatestring nullable required

The endDate that was applied, or null for no upper bound

scope'workspace' | 'mine' required

workspace: every video shared with the workspace. mine: videos the authenticated user created.

startDatestring nullable required

The startDate that was applied, or null for no lower bound

timezonestring required

Time zone used to bucket viewsOverTime

Example response

{
  "geoBreakdown": [
    {
      "country": "US"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "eyJpZCI6IjEyMyJ9"
  },
  "referrerBreakdown": [
    {
      "referrerDomain": "linkedin.com"
    }
  ],
  "retention": [
    {
      "percent": 42
    }
  ],
  "scope": "workspace",
  "summary": {
    "avgPercentViewed": 63.5,
    "pageOpens": 1610,
    "totalViews": 1280,
    "totalWatchTimeSeconds": 48210.4,
    "uniqueSessions": 940
  },
  "timezone": "UTC",
  "topVideos": [
    {
      "avgPercentViewed": 71.2,
      "name": "Q3 product update",
      "videoId": "vid_abc123def456"
    }
  ],
  "viewsOverTime": [
    {
      "date": "2026-01-14"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.