Timeframe parameter now accepted on breakdown and timeseries endpoints

Back to Changelog
FEB 4, 2026
NewVideo DataAPI

The Data query API now accepts a timeframe parameter on both breakdown and timeseries endpoints. You can request results for any supported window without changing default account settings or post-processing on the client side.

Highlights:

  • Consistent across endpoints — the same timeframe semantics that power overall and list-of-views now apply uniformly to breakdown and timeseries queries.
  • Bucket size returned — bucket size is included on the timeseries response and is derived from the requested timeframe, so clients can render axes without a second call.
  • Excludes unsupported ranges — combinations that previously produced inconsistent buckets (60-minute and 6-hour) are now rejected up front with a clear error, instead of returning unaligned data.

This change makes it easier to build custom dashboards that compare arbitrary windows against the same metric and dimension set.