Analytics timeseries [+]
Studio
Analytics timeseries [+]
Bucketed revenue and order series for a window and its previous window, ready to chart.
GET
Analytics timeseries [+]
Revenue and order counts bucketed over time, for the requested window and the equivalent previous window, so you can draw “current vs previous” comparison charts directly. The bucket size adapts to the window: hourly for day windows, daily for week/month windows, monthly for the year.
Tier: Premium, requires a premium key and an active Branding+ subscription (checked on every request).
Request
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
period | string | last7d | today, yesterday (hourly) · last7d, last30d, last90d, thisWeek, thisMonth (daily) · thisYear (monthly). |
Response
| Field | Description |
|---|---|
bucket | hour, day, or month, derived from period. |
current.labels | Human-readable x-axis labels; empty buckets are included so the axis is continuous. |
current.revenue | Net revenue per bucket, numbers in USD dollars. |
deltas | Percentage change of the window totals vs the previous window. |
Errors
| HTTP | Code | When |
|---|---|---|
| 403 | PREMIUM_KEY_REQUIRED | The key is basic-tier. |
| 403 | SUBSCRIPTION_INACTIVE | Premium key, but the Branding+ subscription is no longer active. |