Get hourly metrics for selected videos (POST)

Hourly metrics for a list of videos, identified by video_external_id. Same response as /general/hour, filtered to the given videos. Use POST for long lists (up to 2000 IDs).

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
videos
array of strings
required
length ≤ 2000

video_external_id list (up to 2000).

videos*
string
required
^\d{4}-\d{2}-\d{2}(T\d{2}:00)?$
string
required
^\d{4}-\d{2}-\d{2}(T\d{2}:00)?$
string
Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json