Skip to Content
GrowSocialelion API
Read endpoints

Get the following feed

The brand account's following feed on one network.

POST /api/v1/get_feed · MCP tool get_feed · scope read

The brand account's following feed on one network. Never stored, so it needs refresh: true. Free by default: it serves what this app already stored, with `asOf`. `refresh: true` makes ONE live read of at most 25 items. On X a refresh is billed: 1 credit per post read and 2 credits per user read, 2 credits per trends read (X's published rates), checked against your credits first. Each refresh is billed on its own: repeating one is NOT free. At most 50 billed refreshes per key and 100 per workspace (all keys together) per UTC day, one at a time per workspace (a second in flight is refused as busy); the Free plan does not read X. A refresh needs the brand's read switch for that kind on (Agent → Permissions), and a billed refresh needs the key's `spend` scope as well as `read`. Bluesky, Mastodon and other free networks cost nothing. Stored data is served even while a connection needs reconnecting. No agent run, no model. Text other people wrote (posts, authors, URLs of their posts) comes back only under `untrusted`, keyed by item id.

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. A fresh read on a billed network costs credits and needs spend; stored data is free.

Arguments

NameTypeRequiredDescription
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"NoConnected network id (from get_capabilities). Omit for the brand's primary.
limitintegerNoItems, at most 25.
refreshbooleanNotrue = one live read (may be billed, see description). Default: stored data.

Request

curl -X POST https://growsocialelion.com/api/v1/get_feed \
  -H "Authorization: Bearer gse_mcp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

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",
  "network": "string",
  "source": "string",
  "asOf": "string",
  "items": [
    {
      "id": "string"
    }
  ],
  "cost": {
    "billed": false
  },
  "untrusted": {
    "notice": "string"
  }
}

Errors use the shared body. See Errors. The full schema is in the API reference.