Infomaniak Streaming Video icon

Infomaniak Streaming Video

Interact with Infomaniak Streaming Video API

Actions92

Stats > Channel > Viewing → Viewing Histogram Par Channel

AI-generated

Summary

Fetches viewing histogram per channel per selected time interval for a given account.

Inputs

  • authentication — Authentication method: OAuth2 or API Key.
  • path_channel (required) — Channel identifier (Pack order ID).
  • query_from (required) — Start date for the consumption period (ISO format).
  • query_to (required) — End date for the consumption period (ISO format).
  • query_per (required) — Granularity of the histogram (day, hour, minute, month, quarter, week, year).
  • query_account_id (required) — Account identifier.
  • returnFullResponse — If true, returns the complete API response; otherwise only aggregated data.

Output shape

a single histogram object containing viewing counts per period

The response includes the aggregated counts; pagination is not applicable.

Examples

Example 1: Get daily viewing stats for channel 123 from 2024-01-01 to 2024-01-31

authentication=oauth2 path_channel=123 query_from=2024-01-01 query_to=2024-01-31 query_per=day query_account_id=456 returnFullResponse=false

Example 2: Retrieve hourly histogram for a specific account over the last week

authentication=apiKey path_channel=789 query_from=2024-10-01T00:00:00Z query_to=2024-10-07T23:59:59Z query_per=hour query_account_id=101 returnFullResponse=true

Example 3: Fetch monthly viewing histogram for a channel using API key

authentication=apiKey path_channel=321 query_from=2023-01-01 query_to=2023-12-31 query_per=month query_account_id=202 returnFullResponse=false

Links

Discussion