Retrieve hourly viewing metrics across all videos for the given date range. Returns two views of the same data: raw entries per video grouped by date and hour, and aggregated totals grouped by date and 2-hour time buckets. Video IDs are video_external_id values.

Time window and time zone

• start_date and end_date accept YYYY-MM-DD or YYYY-MM-DDTHH:00 (minutes must be 00).
• The window is [start, end). A date without an hour covers the whole day: start_date=2026-10-20&end_date=2026-10-20 returns all of October 20.
• timezone (IANA, e.g. America/Sao_Paulo) defines how the dates are read and how days and hours are labeled in the response. Without timezone and without hours in the dates, days and hours are in UTC (same response as before).
• Unique metrics over a window are the sum of the unique metrics of each hour: a viewer who comes back in different hours is counted once per hour.
• Returns 400 for an invalid time zone, a time zone with a non whole-hour UTC offset (e.g. Asia/Kolkata), minutes other than 00, or end_date not after start_date.

Most recent data: with timezone (or hours in the dates) the current day is included up to the last closed hour (hourly processing at minute 5 of each hour, UTC). Without timezone, data goes up to the previous day, available after the daily processing at 00:30 UTC.

{
  "timezone": "America/Sao_Paulo"
}