Analytics

Get video analytics

Viewing analytics for one video: plays, unique sessions, watch time, plays per day, retention per one-percent slice, geography, referrers, UTM traffic sources, and call-to-action clicks. Available to the video's creator, its collaborators, and workspace members it is shared with. Dates are whole UTC days; omit both for all time.

get/v1/videos/{id}/analytics

Request

  • Base URL: https://api.tella.com
  • URL: https://api.tella.com/v1/videos/{id}/analytics
  • Auth: HTTP bearer

Path parameters

idstring required

Unique video identifier

Example:vid_abc123def456

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

Response

OK

ctaClicksinteger required

Clicks on the video's call-to-action button in the range

endDatestring nullable required

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

startDatestring nullable required

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

timezonestring required

Time zone used to bucket viewsOverTime

videoIdstring required

Example response

{
  "ctaClicks": 37,
  "geoBreakdown": [
    {
      "country": "US"
    }
  ],
  "referrerBreakdown": [
    {
      "referrerDomain": "linkedin.com"
    }
  ],
  "retention": [
    {
      "percent": 42
    }
  ],
  "summary": {
    "avgPercentViewed": 63.5,
    "pageOpens": 1610,
    "totalViews": 1280,
    "totalWatchTimeSeconds": 48210.4,
    "uniqueSessions": 940
  },
  "timezone": "UTC",
  "trafficSources": [
    {
      "campaign": "launch-week",
      "medium": "email",
      "source": "newsletter"
    }
  ],
  "videoId": "vid_abc123def456",
  "viewsOverTime": [
    {
      "date": "2026-01-14"
    }
  ]
}

Changes

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