Skip to Content
GrowSocialelion API
Read endpoints

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

NameTypeRequiredDescription
scope"post" | "network" | "brand"Yes
proposalIdstringNoscope 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"Noscope network: the network.
periodDaysnumber | number | numberNo7, 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.