Stream

Get stream air report

GET
https://api.tunio.ai/v1/stream/{stream_id}/air-report

Summarises what aired on a stream over a period (default: the last 24 hours, at most 31 days). Use it to answer questions such as "how often does each jingle play", "are tracks repeating", "were there pauses on air" or "what share of the air is music". The report has: totals (plays, aired seconds, unique tracks, AI and uploaded music, skips); by_kind (music, jingle, announcement, weather, news, time, podcast, story...); timeline in the stream's time zone, hourly for up to 3 days and daily beyond; top_tracks and top_jingles with plays and the shortest / mean interval between repeats in seconds; repeats (music tracks played more than once, and how many came back within an hour); genres; transitions (crossfade, beatmatch, cut, skip...); gaps. A gap is time between the expected end of an item (its start plus its length) and the start of the next one, at least gap_seconds long: dead air, a stopped station, or a missing schedule. not_recorded lists what never reaches the history: overlay jingles (mixed on top of music) and silence filler.

Path parameters

NameTypeDescription
stream_idRequiredstringStream UUID

Query parameters

NameTypeDescription
fromstringStart of the period, RFC 3339 (default: 24 hours before to)
tostringEnd of the period, RFC 3339 (default: now)
topstringHow many top tracks, jingles and genres to return, 1-50 (default 10)
gap_secondsstringShortest pause counted as a gap, 10-86400 seconds (default 60)

Responses

NameTypeDescription
reportobject
-
bucket_sizestring
-
by_kindarray
-
fromstring
-
gapsobject
-
genresarray
-
not_recordedarray
-
repeatsobject
-
timelinearray
-
timezonestring
-
tostring
-
top_jinglesarray
-
top_tracksarray
-
totalsobject
-
transitionsarray
-
successboolean
-
NameTypeDescription
messagestring
Message contains human readable error details.
successboolean
Success is always false for error payloads.
NameTypeDescription
messagestring
Message contains human readable error details.
successboolean
Success is always false for error payloads.
NameTypeDescription
messagestring
Message contains human readable error details.
successboolean
Success is always false for error payloads.
NameTypeDescription
messagestring
Message contains human readable error details.
successboolean
Success is always false for error payloads.