Query creator viewership metrics
Requires a proof of ownership to be sent in the request, which for now is just the assetId or streamId parameters (1 of those must be in the query-string).
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Start timestamp for the query range (inclusive)
End timestamp for the query range (exclusive)
The time step to aggregate viewership metrics by
hour, day, week, month, year The asset ID to filter metrics for
The stream ID to filter metrics for
The creator ID to filter the query results
The list of fields to break down the query results. Specify this query-string multiple times to break down by multiple fields.
deviceType, device, cpu, os, browser, browserEngine, continent, country, subdivision, timezone, viewerId Response
The total playtime in minutes for the stream/asset.
The number of views for the stream/asset.
The browser used by the viewer.
The browser engine used by the viewer's browser.
The continent where the viewer is located.
The country where the viewer is located.
The CPU used by the viewer's device.
The ID of the creator associated with the metric.
The device used by the viewer.
The type of the device used by the viewer.
The URL of the distributed storage used for the asset
The error rate for the stream/asset.
The percentage of sessions that existed before the asset started playing.
Geographic encoding of the viewers location. Accurate to 3 digits.
The operating system used by the viewer.
The playback ID associated with the metric.
The rebuffering ratio for the asset.
The subdivision (e.g., state or province) where the viewer is located.
Timestamp (in milliseconds) when the metric was recorded. If the query contains a time step, this timestamp will point to the beginning of the time step period.
The timezone where the viewer is located.
The time-to-first-frame (TTFF) in milliseconds.
The ID of the viewer associated with the metric.
Was this page helpful?