Skip to main content
GET
Publisher usage analytics (all my apps, filterable)

Authorizations

Authorization
string
header
required

DataHub API Key

Query Parameters

group_by
string
default:day

one or two comma-separated dimensions from day / hour / data_app / triggered_by / state / version / error / caller (e.g. day,data_app); day and hour are two granularities of the same time axis and cannot be combined; state / version / error / caller are computed from run details and need a bounded range of at most 92 days; caller additionally needs exactly one private or shared data_app; default day

data_app
string[] | null

restrict to these apps (<username>/<app_name>, repeatable); default = all my apps

created_from
string | null
created_to
string | null
tz_offset
integer
default:0

timezone offset for day / hour buckets (minutes relative to UTC, e.g. 480 for UTC+8); default 0 means UTC. Fixed offset, no DST; buckets are hourly so half-hour offsets are approximated to the hour

Required range: -720 <= x <= 840
triggered_by
string | null

restrict to one calling channel (api / sdk / mcp / web …, the same value as the runs list filter)

include_test
boolean
default:false
compare
boolean
default:false

also return previous_totals for the equal-length range immediately before created_from (requires both bounds)

Response

Successful Response

data
PublisherUsage · object
required

Publisher-side usage analytics: totals over the range (optionally the preceding equal-length range for period-over-period comparison) and a breakdown by up to two dimensions.