Actions92
- Channel Actions
- Channel > Config Actions
- Event Actions
- Integrations Actions
- Live Actions
- Misc > Countries Actions
- Misc > Stream Actions
- Option Actions
- Option > Record Actions
- Option > Record > Instant Actions
- Option > Record > Storage Actions
- Option > Timeshift Actions
- Option > Watermarking Actions
- Option > Simulcast Actions
- Players Actions
- Players > Ads Actions
- Players > Embeds Actions
- Players > Pictures Actions
- Prices Actions
- Restrictions Actions
- Stats > Channel > Connection History Actions
- Stats > Channel > Consumption Actions
- Stats > Channel > Export Stats Actions
- Stats > Channel > Geolocation Actions
- Stats > Channel > Technologies Actions
- Stats > Channel > Viewers Actions
- Stats > Channel > Viewing Actions
- Stats > Globals > Consumption Actions
- Stats > Globals > Geolocation Actions
- Stats > Globals > Viewers Actions
- Stats > Globals > Viewing Actions
- Thumbnail Actions
- Order Actions
Stats > Channel > Viewing → Viewing Histogram Par Channel
AI-generatedSummary
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