Skip to main content
GET
Aggregate post performance over a window

Use Platform Analytics for your own channel

This endpoint and GET /analytics/{integration} answer the same question — “what performed well?” — through different doors: So: your own account → Platform Analytics. Read Metrics earns its cost when the account is not yours, or has no connected channel — cases Platform Analytics cannot see at all.

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

Authorization
string
header
required

Your Groniz API key

Path Parameters

platform
enum<string>
required

Platform to read from. Only x is supported today.

Available options:
x

Query Parameters

username
string

Account handle, without the @. Either username or user_id is required.

user_id
string

Platform user id. Cheaper than username (skips the handle lookup). Either username or user_id is required.

limit
integer
default:50

Maximum items to return. Default 50, capped at 200.

Required range: x <= 200
since
string

Lookback 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.

Response

The aggregate

user_id
string
window
object
sample_size
integer

Posts in the window

metrics
object[]
posts
object[]
totals
object
averages
object | null

null when sample_size is 0 — an average over zero posts is undefined, NOT zero engagement. Widen since.