Get metrics
Stored engagement for one post (scope post + proposalId), one network (scope network + network) or the brand (scope brand), over 7, 30 or 90 days, compa...
GET | POST /api/v1/get_metrics · MCP tool get_metrics · scope read
Stored engagement for one post (scope post + proposalId), one network (scope network + network) or the brand (scope brand), over 7, 30 or 90 days, compared with the period before. A metric a network does not report is null with a reason, never 0. YouTube is never added into a cross-network total; its own figures come back apart. Free, from this app's store; `asOf` says when the newest snapshot was taken.
Scope. Read your own brand data: posts, metrics, runs, the audit trail, the plan, stored mentions and trends. Free, unless you ask a billed network for a fresh read. This endpoint never costs credits.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
scope | "post" | "network" | "brand" | Yes | |
proposalId | string | No | scope post: a proposalId from list_posts. |
network | "x" | "bluesky" | "mastodon" | "pixelfed" | "telegram" | "devdotto" | "discord" | "ghost" | "lemmy" | "nostr" | "tumblr" | "wordpress" | "misskey" | "qiita" | "tabnews" | "youtube" | "dailymotion" | "tiktok" | "hashnode" | "peertube" | "dribbble" | "slack" | "wykop" | "plurk" | "kick" | "twitch" | "hatena" | "line" | No | scope network: the network. |
periodDays | number | number | number | No | 7, 30 (default) or 90. |
compareTo | "previous" | "none" | No |
Request
curl -X POST https://growsocialelion.com/api/v1/get_metrics \
-H "Authorization: Bearer gse_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"scope":"brand","periodDays":28}'Response
200 with the tool's answer. The shape below is generated from the output schema; real answers can carry more fields.
{
"status": "string",
"code": "string",
"reason": "string",
"scope": "string",
"asOf": "string",
"rows": [
{
"metric": "string",
"value": 1
}
]
}Errors use the shared body. See Errors. The full schema is in the API reference.