Read Metrics
Totals and averages across an account’s posts in a window, plus the posts themselves. For YOUR OWN connected channel prefer GET /analytics/{integration} — it answers the same question over the channel’s OAuth token, for free.
Use Platform Analytics for your own channel
This endpoint andGET /analytics/{integration} answer the
same question — “what performed well?” — through different doors:
averages is null, not zero
When no posts fall inside the window, sample_size is 0 and averages is null — an
average over zero posts is undefined, not “zero engagement”. Widen since before
concluding anything about the account.
since accepts a duration (30d, 12h), a date (2026-07-01), or an ISO timestamp, and
defaults to 30d. An unparseable value returns 400 rather than silently dropping the window.Authorizations
Your Groniz API key
Path Parameters
Platform to read from. Only x is supported today.
x Query Parameters
Account handle, without the @. Either username or user_id is required.
Platform user id. Cheaper than username (skips the handle lookup). Either username or user_id is required.
Maximum items to return. Default 50, capped at 200.
x <= 200Lookback window: a duration (30d, 12h, 45m, 30s), a date (2026-07-01), or an ISO timestamp. Anything else returns 400 — the window is never silently ignored. Defaults to 30d.
