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
| Name | Type | Required | Description |
|---|---|---|---|
groups | "mentions_replies" | "quotes_reposts" | "likes" | "follows" | "own_posts" | "profile" | "mutes_blocks"[] | No | Only these groups. Omit for every group that is turned on. |
since | string | No | ISO time; events received at or after it. |
until | string | No | ISO time; events received before it. |
limit | integer | No | Items, default 25, at most 100. |
cursor | string | No | The 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.