Stream
Get stream air report
https://api.tunio.ai/ v1/ stream/ {stream_id}/ air-reportSummarises 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
| Name | Type | Description |
|---|---|---|
| stream_idRequired | string | Stream UUID |
Query parameters
| Name | Type | Description |
|---|---|---|
| from | string | Start of the period, RFC 3339 (default: 24 hours before to) |
| to | string | End of the period, RFC 3339 (default: now) |
| top | integer | How many top tracks, jingles and genres to return, 1-50 (default 10) |
| gap_seconds | integer | Shortest pause counted as a gap, 10-86400 seconds (default 60) |
Responses
| Name | Type | Description |
|---|---|---|
| report | object | The air report. |
| bucket_size | string | Timeline bucket size: "hour" for periods up to 72 hours, "day" for longer ones. |
| by_kind | array | Plays and aired length per content kind. |
| from | string | Start of the period (UTC). |
| gaps | object | Pauses on air. |
| genres | array | Most played genres (up to top). |
| not_recorded | array | What never reaches the play history and is missing from the report: overlay_jingles (jingles mixed on top of music) and silence_filler. |
| repeats | object | Repeat statistics for music tracks. |
| timeline | array | Plays per hour or per day. |
| timezone | string | Time zone of the timeline buckets: the stream's time zone, or UTC when it has none. |
| to | string | End of the period (UTC). |
| top_jingles | array | Most played jingles (up to top). |
| top_tracks | array | Most played music tracks (up to top). |
| totals | object | Totals over the period. |
| transitions | array | Plays per transition type. |
| success | boolean | Always true. |
| Name | Type | Description |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| Name | Type | Description |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| Name | Type | Description |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| Name | Type | Description |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |
| Name | Type | Description |
|---|---|---|
| message | string | Error code or human-readable error details. |
| success | boolean | Always false for error payloads. |