GET
/
data
/
views
/
query
Authorization
Query
curl --request GET \
  --url https://livepeer.studio/api/data/views/query \
  --header 'Authorization: <authorization>'
[
  {
    "browser": "<string>",
    "browserEngine": "<string>",
    "continent": "<string>",
    "country": "<string>",
    "cpu": "<string>",
    "creatorId": "<string>",
    "dStorageUrl": "<string>",
    "device": "<string>",
    "deviceType": "<string>",
    "errorRate": 123,
    "exitsBeforeStart": 123,
    "geohas": "<string>",
    "os": "<string>",
    "playbackId": "<string>",
    "playtimeMins": 123,
    "rebufferRatio": 123,
    "subdivision": "<string>",
    "timestamp": 1587667174725,
    "timezone": "<string>",
    "ttffMs": 123,
    "viewCount": 123,
    "viewerId": "<string>"
  }
]

Authorizations

Authorization
string
headerrequired

Bearer api-key

Query Parameters

playbackId
string

The playback ID to filter the query results. This can be a canonical playback ID from Livepeer assets or streams, or dStorage identifiers for assets

from

Start timestamp for the query range (inclusive)

to

End timestamp for the query range (exclusive)

timeStep
enum<string>

The time step to aggregate viewership metrics by

Available options:
hour,
day,
week,
month,
year
assetId
string

The asset ID to filter metrics for

streamId
string

The stream ID to filter metrics for

creatorId
string

The creator ID to filter the query results

breakdownBy[]
enum<string>[]

The list of fields to break down the query results. Specify this query-string multiple times to break down by multiple fields.

Available options:
playbackId,
deviceType,
device,
cpu,
os,
browser,
browserEngine,
continent,
country,
subdivision,
timezone,
geohash,
viewerId,
creatorId

Response

200 - application/json
browser
string

The browser used by the viewer

browserEngine
string

The browser engine used by the viewer's browser

continent
string

The continent where the viewer is located

country
string

The country where the viewer is located

cpu
string

The CPU used by the viewer's device

creatorId
string

The ID of the creator associated with the metric

dStorageUrl
string

The URL of the distributed storage used for the asset

device
string

The device used by the viewer

deviceType
string

The type of the device used by the viewer

errorRate
number

The error rate for the asset

exitsBeforeStart
number

The percentage of sessions that existed before the asset started playing

geohas
string

Geographic encoding of the viewers location. Accurate to 3 digits.

os
string

The operating system used by the viewer

playbackId
string

The playback ID associated with the metric

playtimeMins
number
required

The total playtime in minutes for the asset

rebufferRatio
number

The rebuffering ratio for the asset

subdivision
string

The subdivision (e.g., state or province) where the viewer is located

timestamp
number

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.

timezone
string

The timezone where the viewer is located

ttffMs
number

The time-to-first-frame (TTFF) in milliseconds

viewCount
integer
required

The number of views for the asset

viewerId
string

The ID of the viewer associated with the metric

Was this page helpful?

Transcode a videoQuery usage metrics