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.

路径参数

名称类型说明
stream_idRequiredstringStream UUID

查询参数

名称类型说明
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)

响应

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