Get hourly metrics for selected videos

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…
Query Params
string
required
^\d{4}-\d{2}-\d{2}(T\d{2}:00)?$

Start of the window: YYYY-MM-DD (start of the day) or YYYY-MM-DDTHH:00, in timezone.

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

End of the window, exclusive: YYYY-MM-DDTHH:00 stops right before that hour; YYYY-MM-DD includes the whole day. Read in timezone.

string

IANA time zone used to read start_date/end_date and to label days and hours in the response (e.g. America/Sao_Paulo, America/New_York, UTC). When omitted and the dates have no hour, everything is in UTC.

string
required

Comma-separated video_external_id list.

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