Infomaniak Streaming Radio icon

Infomaniak Streaming Radio

Interact with Infomaniak Streaming Radio API

Actions141

Stats > Hls Stream → Get Listeners By Minute

AI-generated

Summary

Fetch listener counts per minute for a specified Infomaniak radio product and station within a given time range.

Inputs

  • authentication (required) — Authentication method to use; either OAuth2 or API Key.
  • path_radio_product_id (required) — The ID of the radio product whose HLS stream statistics are requested.
  • path_station_id (required) — The ID of the station for which listener statistics are requested.
  • query_from (required) — Start timestamp (ISO 8601) for the period to retrieve statistics.
  • query_to (required) — End timestamp (ISO 8601) for the period to retrieve statistics.
  • returnFullResponse — If true, the full API response is returned; otherwise only the processed listener data is returned.

Output shape

An array of objects, each containing a minute identifier and the corresponding listener count.

The array is not paginated; if no data is available an empty array is returned. When returnFullResponse is true, the raw API response structure is returned instead.

Examples

Example 1: Retrieve minute‑by‑minute listeners for a radio product between two dates using API Key.

authentication: apiKey; path_radio_product_id: 123; path_station_id: 456; query_from: '2024-09-01T00:00:00Z'; query_to: '2024-09-01T01:00:00Z'; returnFullResponse: false

Example 2: Get full response for a stream using OAuth2.

authentication: oauth2; path_radio_product_id: 789; path_station_id: 101; query_from: '2024-09-02T12:00:00Z'; query_to: '2024-09-02T13:00:00Z'; returnFullResponse: true

Example 3: Fetch listener data for a specific minute range and return only processed data.

authentication: oauth2; path_radio_product_id: 345; path_station_id: 678; query_from: '2024-09-03T08:00:00Z'; query_to: '2024-09-03T09:00:00Z'; returnFullResponse: false

Links

Discussion