Skip to main content
GET
Retrieve Livestream Viewership

Authorizations

Authorization
string
header
required

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Scopes

livestream:moderate

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-11-14-1"

Path Parameters

id
string
required

Livestream ID, prefixed lfeed_.

Response

livestream viewership retrieved

average_viewers
number
required

Average number of viewers watching at once, not counting the host: watch_time_seconds divided by how long the livestream has run, rounded to one decimal place.

Example:

31.1

new_members
integer
required

Number of members who joined the account between the start of the livestream and its end, or now while it is live. Team members are not counted.

Example:

1

peak_viewers
integer
required

Highest number of viewers watching at once, not counting the host.

Example:

164

peak_viewers_at
string | null
required

When the livestream first reached peak_viewers, as an ISO 8601 timestamp. null when nobody watched.

Example:

"2026-01-01T12:00:00.000Z"

tracked
boolean
required

Whether viewer activity was tracked for this livestream. false before it starts, and after it ends when nothing was recorded, such as for livestreams from before viewer tracking existed. Every viewer count is then 0.

Example:

true

unique_viewers
integer
required

Number of distinct people who watched, not counting the host. A signed-out guest counts once per visit.

Example:

182

viewers
object[]
required
watch_time_seconds
integer
required

Total time viewers spent watching, in seconds, not counting the host.

Example:

197340