Read performance
Every published post with its latest samples and the 90-day series, the account's numbers per day per connected account (reach and engagements gained, posts published, follower captures) for KPIs and charts, one post's accrual curve against the account's median, follower counts with the weekly delta, and a refresh that calls the platforms for stale samples.
The lift number a post carries is its performance against its channel's median, which is what an agent should compare drafts to before proposing the next one.
Ask in plain words
- "which post did best this month"
- "how are followers trending on Instagram"
- "refresh the numbers and tell me what worked"
- "which platform is growing my followers fastest"
- "how many views did each account get per day this month"
From an agent host (MCP)
Server: https://shapelessai.com/mcp (add it to your host).
metrics_daily: The account's numbers per UTC day for the lastdays(default 30, up to 365), whole and per connected account: reach (views) and engagements gained that day by every post, old ones included, posts published that day, and each account's follower captures (read about weekly; a day without one is absent, never filled in). For KPIs, a chart or "how did this week go". Reads stored numbers, free, nothing charged. Needs the read scope.
From code (REST)
Bearer API key with the scope each call names (auth, OpenAPI).
GET /api/metrics(read scope): Published posts with their latest samples and the 90-day series.GET /api/metrics/history(read scope): One post's accrual curve against the account median (?post=).GET /api/metrics/followers(read scope): Follower counts and the weekly delta.GET /api/metrics/daily(read scope): The account's numbers per UTC day for the last ?days (1 to 365, default 30, today included), whole and per connected account: reach (views) and engagements GAINED that day by every post, old ones included, posts published that day, and each account's follower captures (about weekly; a day without one is absent, never filled in). Reads stored samples only; POST /api/metrics/refresh calls the platforms.POST /api/metrics/refresh(write scope): Refresh stale samples (calls the platforms).
From a terminal (CLI)
shapeless metrics
Example
Refusals
| Status | Meaning |
|---|---|
| 400 | days is not a whole number from 1 to 365. |
Where else
More in Signal
List a tool on the Shapeless Directory, or search it · Pick your reference creators and competitors · Find out who is who on social · Audit a profile · Boost with paid
