v1

latestOpenAPI 3.1.02026-07-2416666272.6 KB

Get Best Times General Metrics

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.

get/general/hour

Query parameters

start_datestring date required

Example:2026-04-25

Start date of the range. Format: YYYY-MM-DD.

end_datestring date required

Example:2026-05-25

End date of the range. Format: YYYY-MM-DD.

Response

Hourly viewing metrics. Contains two views of the same data: raw entries (views_data) and aggregated 2-hour buckets (aggregated_data).

views_dataobject

Raw hourly entries keyed by date (YYYY-MM-DD).

aggregated_dataobject

Totals keyed by date (YYYY-MM-DD). Each value is an object whose keys are 2-hour buckets (0-2, 2-4, 4-6, 6-8, 8-10, 10-12, 12-14, 14-16, 16-18, 18-20, 20-22, 22-00).