Infomaniak Streaming Radio icon

Infomaniak Streaming Radio

Interact with Infomaniak Streaming Radio API

Actions141

Stats > Streams → Get Listeners By Minute

AI-generated

Summary

Retrieves listener counts per minute for a specific radio stream within a defined time range.

Inputs

  • authentication (required) — Authentication method: OAuth2 or API Key.
  • path_radio_product_id (required) — Identifier of the radio product (stream).
  • path_station_id (required) — Identifier of the station.
  • path_stream_id (required) — Identifier of the stream.
  • query_from (required) — Start timestamp for the request (ISO 8601 format).
  • query_to (required) — End timestamp for the request (ISO 8601 format).
  • returnFullResponse — If true, returns the full API response; otherwise only listener data.

Output shape

array of objects, each containing a minute timestamp and corresponding listener count

When returnFullResponse is false only the listener data array is returned; with true the complete API payload is provided. No pagination is applied.

Examples

Example 1: Fetch minute‑level listeners for a stream between 2024‑09‑01T00:00:00Z and 2024‑09‑01T01:00:00Z using OAuth2.

authentication: oauth2, path_radio_product_id: 123, path_station_id: 45, path_stream_id: 6, query_from: '2024-09-01T00:00:00Z', query_to: '2024-09-01T01:00:00Z', returnFullResponse: false

Example 2: Retrieve the full API response for a specific product, station, and stream over a 24‑hour window using an API key.

authentication: apiKey, path_radio_product_id: 10, path_station_id: 20, path_stream_id: 30, query_from: '2024-09-01T00:00:00Z', query_to: '2024-09-02T00:00:00Z', returnFullResponse: true

Example 3: Get listener data for a single minute with minimal configuration.

authentication: oauth2, path_radio_product_id: 5, path_station_id: 6, path_stream_id: 7, query_from: '2024-09-01T12:00:00Z', query_to: '2024-09-01T12:01:00Z', returnFullResponse: false

Links

Discussion