Skip to main content
GET
List a video's raw events

Authorizations

Authorization
string
header
required

A scoped token minted in Settings → API tokens. Send it as Authorization: Bearer tplt_… or X-API-Key: tplt_….

Path Parameters

video
integer
required

The video's numeric ID.

Query Parameters

from
string<date>

Start of the range, as an ISO date. Defaults to 7 days ago.

to
string<date>

End of the range, as an ISO date. Defaults to today.

tz
string
default:UTC

Timezone the range is read in, as an IANA name. Defaults to UTC.

event_type
string

Return only this event type, e.g. play, pause, ended, or conversion. Omit to return every type.

page
integer
default:1

Which page to return. Defaults to 1.

per_page
integer
default:100

Rows per page. Defaults to 100. Capped at 500.

Required range: x <= 500

Response

One page of events.

video_id
integer
page
integer

The page returned.

per_page
integer

Rows per page.

events
object