Infomaniak Streaming Radio icon

Infomaniak Streaming Radio

Interact with Infomaniak Streaming Radio API

Actions141

Stats > Stations → Get Listeners By Stream

AI-generated

Summary

Retrieves listener statistics for a specified stream and time period.

Inputs

  • authentication — Authentication method (OAuth2 or API Key)
  • path_radio_product_id (required) — Unique identifier of the radio product to request.
  • path_station_id (required) — Unique identifier of the station to request.
  • query_from (required) — Start date for listener statistics (YYYY-MM-DD).
  • query_to (required) — End date for listener statistics (YYYY-MM-DD).
  • queryParameters — Additional query parameters to customize the API request.
  • returnFullResponse — Whether to return the complete API response or simplified status.

Output shape

list of listener statistics records

Response format varies by query parameters; returns aggregated listener counts per stream.

Examples

Example 1: Retrieve listener stats for stream 123 from Jan 1 to Dec 31, 2023

path_radio_product_id=123, path_station_id=456, query_from=2023-01-01, query_to=2023-12-31

Example 2: Get API key authenticated listener data for stream 789

authentication=apiKey, path_radio_product_id=789, query_with_empty=true

Example 3: Fetch full response for stream 321 using OAuth2

authentication=oauth2, path_radio_product_id=321, returnFullResponse=true

Links

Discussion