Skip to Content
GrowSocialelion API
Read endpoints

Get X activity events

X activity events this brand subscribed to on Brand → X: mentions & replies, quotes & reposts, likes, follows & unfollows, own posts created and deleted...

GET | POST /api/v1/get_x_activity · MCP tool get_x_activity · scope read

X activity events this brand subscribed to on Brand → X: mentions & replies, quotes & reposts, likes, follows & unfollows, own posts created and deleted, profile changes, mutes & blocks. Only groups the customer turned on are returned; a group that is off returns nothing. Filter by group and by the time the event arrived (ISO since/until), newest first, with a cursor. Free: it reads what X already delivered and this app stored (each event was charged once, on delivery); no X call. Read only. 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. This endpoint never costs credits.

Arguments

NameTypeRequiredDescription
groups"mentions_replies" | "quotes_reposts" | "likes" | "follows" | "own_posts" | "profile" | "mutes_blocks"[]NoOnly these groups. Omit for every group that is turned on.
sincestringNoISO time; events received at or after it.
untilstringNoISO time; events received before it.
limitintegerNoItems, default 25, at most 100.
cursorstringNoThe nextCursor from the previous page. Omit for the newest.

Request

curl -X POST https://growsocialelion.com/api/v1/get_x_activity \
  -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",
  "groupsOn": [
    "string"
  ],
  "items": [
    {
      "id": "string",
      "group": "string",
      "eventType": "string"
    }
  ],
  "nextCursor": "string",
  "untrusted": {
    "notice": "string"
  }
}

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