Skip to main content
GET
Get video analytics

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Unique video identifier

Example:

"vid_abc123def456"

Query Parameters

startDate
string

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

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-01-01"

endDate
string

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

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-01-01"

timezone
string

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

Example:

"America/New_York"

Response

OK

Viewing analytics for one video

ctaClicks
integer
required

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

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

37

endDate
string | null
required

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

geoBreakdown
object[]
required

Plays by country, up to 100 rows by views

referrerBreakdown
object[]
required

Plays by referring domain, up to 100 rows by views

retention
object[]
required

Watch counts per one-percent slice of the video, ascending

startDate
string | null
required

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

summary
object
required

Headline viewing metrics

timezone
string
required

Time zone used to bucket viewsOverTime

Example:

"UTC"

trafficSources
object[]
required

Plays by UTM source, medium and campaign, up to 100 rows by views

videoId
string
required
Example:

"vid_abc123def456"

viewsOverTime
object[]
required

Plays per day, ascending