Skip to content

  Timeseries

Timeseries queries support all the normal filters, but it's resolution can be set to 1 hour, day, week or month.

Week resolution will group results by the ISO week and month resolution will group by calendar month.

Note

When using 1 week or 1 month resolution, the reporting period may be automatically adjusted to ensure it includes a full ISO week or calendar month. For example, performing a month query with start data of 6 June and end date of 15 July, the range will automatically adapt to include from 1 June to 31 July and so include 2 complete months.

Totals timeseries

Returns total metrics aggregated per specified resolution over the reporting period.

Get timeseries totals for stream '123' over the past 30 days in the default (hourly) resolution
"<base>/stream/timeseries/totals?range=last_30_days&stream_id=123"

"metadata": {
    "resolution: 60"
}
"results": [
    {
        "time": "2025-07-24 14:00:00",
        "users": 29031,
    },
    {
        "time": "2025-07-24 15:00:00",
        "users": 30576,
    },
    ...
]

Get timeseries totals for June and July 2025 in monthly resolution
"<base>/stream/timeseries/totals?from=2023-06-01&to=2025-07-31&resolution=1mon"

"metadata": {
    "resolution: 44640"
}
"results": [
    {
        "time": "2025-06-01 00:00:00",
        "users": 29031,
    },
    {
        "time": "2025-07-01 00:00:00",
        "users": 30576,
    },
    ...
]

Published episode timeseries

Returns number of episodes published as timeseries data.

Uses custom results that only include the number of published episodes.

Supported on podcast

Get timeseries totals for stream '123' over the past 30 days in daily resolution
"<base>/podcast/timeseries/published?range=last_30_days&resolution=1d"

"metadata": {
    "resolution: 60"
}
"results": [
    {
        "time": "2020-04-07 03:00:00.000000",
        "published": 0,
    },
    {
        "time": "2025-07-24 15:00:00",
        "published": 1,
    },
    ...
]