Time Ranges

Facebook-Meta-Ads

Definition

An array of multiple time range objects for overlapping or comparative queries. Each entry has since and until, and each range returns a separate result set. When time_ranges is specified, it overrides date_preset, time_range, and time_increment. It's useful for cumulative or side-by-side date comparisons.

Example

time_ranges=[{'since':'2025-05-01','until':'2025-05-15'},{'since':'2025-06-01','until':'2025-06-15'}]

Stop Juggling Dashboards. Start Growing Get your data flowing today, free plan available.