Get server analytics
/api/analytics/serverThe Discord analytics page: is the Discord server healthy, and who keeps it going? Discord's member count, joins and leaves, messages and voice minutes per day, people active each day and over the week and thirty days before it, the busiest channels and hours (UTC), moderation actions, the people who sent the most, new members who stayed after 7 and 30 days, and member health now: how many members were active in the last thirty days and who went quiet. Active means sent a message or spent time in voice; bots are left out. Series come from daily totals.
Needs the ViewAnalytics permission.
An API key, made on Settings, API keys. Every key starts with mbk_.
In: header
Query Parameters
int32datedateResponse Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/analytics/server"{ "from": "2019-08-24", "to": "2019-08-24", "today": null, "server": { "guildId": null, "name": null, "iconUrl": null, "bannerUrl": null, "createdAt": null, "members": null, "online": null, "boostCount": null, "boostLevel": null }, "week": { "from": "2019-08-24", "to": "2019-08-24", "newMembers": { "thisWeek": 0.1, "lastWeek": 0.1 }, "talked": { "thisWeek": 0.1, "lastWeek": 0.1 }, "messages": { "thisWeek": 0.1, "lastWeek": 0.1 }, "voiceMinutes": { "thisWeek": 0.1, "lastWeek": 0.1 } }, "reach": null, "membersNow": { "members": 0, "linked": 0, "joined": 0, "newAccounts": 0, "newAccountsStillHere": 0, "tenure": { "underAMonth": 0, "oneToSixMonths": 0, "sixToTwelveMonths": 0, "yearOrMore": 0 } }, "memberCount": [ { "day": "2019-08-24", "value": 0.1 } ], "joined": [ { "day": "2019-08-24", "value": 0.1 } ], "left": [ { "day": "2019-08-24", "value": 0.1 } ], "messages": [ { "day": "2019-08-24", "value": 0.1 } ], "voiceMinutes": [ { "day": "2019-08-24", "value": 0.1 } ], "active": [ { "day": "2019-08-24", "daily": 0, "weekly": 0, "monthly": 0 } ], "busiestChannels": [ { "id": "string", "name": null, "type": null, "category": null, "removed": true, "messages": 0.1 } ], "hourOfWeek": { "messages": [ 0.1 ] }, "newMembers": [ { "days": 0, "joined": 0, "stillHere": 0, "stillActive": 0 } ], "bans": [ { "day": "2019-08-24", "value": 0.1 } ], "kicks": [ { "day": "2019-08-24", "value": 0.1 } ], "timeouts": [ { "day": "2019-08-24", "value": 0.1 } ], "messagesRemoved": [ { "day": "2019-08-24", "value": 0.1 } ], "topContributors": [ { "who": { "platform": "string", "id": "string", "name": null }, "messages": 0.1, "voiceMinutes": 0.1 } ], "health": { "members": 0, "activeLast30Days": 0, "wentQuiet": 0, "quiet": [ { "who": { "platform": "string", "id": "string", "name": null }, "messages": 0.1, "voiceMinutes": 0.1 } ] }, "daysWithoutBot": [ "2019-08-24" ], "daysWithoutMessages": [ "2019-08-24" ], "coverage": { "dailyTotalsFirstDay": null, "dailyTotalsLastDay": null, "dailyTotalsUpdatedAt": null, "factFirstDay": null, "factLastDay": null, "retentionConfigured": true, "moderationFactRetentionDays": 0, "presenceFactRetentionDays": 0 }, "generatedAt": "2019-08-24T14:15:22Z"}Get group info GET
The group as its VRChat page shows it: name, short code and discriminator, icon and banner, description, rules, languages (VRChat's codes, such as `eng`) and links, with the member and online counts from the newest reading. All of it is what the group-info sync last read, about every five minutes; opening the page asks VRChat nothing. `readAt` is when that sync last read the group. Needs the `ViewAnalytics` permission.
Get team analytics GET
The Stats page's Moderation tab: is moderation keeping up, and is the team OK? Actions on people (instance kicks, warns, bans, removals, join requests turned away) and door work and admin (invites, approvals, unbans, role changes), counted apart and never added together, from daily totals. The caller's own numbers (`you`, by their linked VRChat account) beside the team's middle (`middle`, left out below four active moderators). Each moderator's own numbers (`moderators`) and who left an instance last (`coverageGaps[].lastModerator`) need ViewAuditLog as well; without it `canSeeEachModerator` is false, `moderators` is empty and `lastModerator` is null. Coverage gaps are stretches when people were in a group instance and no moderator was, from the companion's presence reports. A moderator is present when a paired client is reporting from the instance or when somebody recognised as a moderator (holds a role with moderation permissions, or has taken a moderation action) is seen there. Moderators without the client are not seen at all. `cover` lays them over the hours of the week (168 buckets, Monday 00:00 UTC first): hours when a group instance held at least `people` people by VRChat's head count, those a gap overlapped, and those no companion reported from. `people` defaults to the saved setting. `waits` gives the middle wait of join requests (request to approval or rejection), AutoMod flags (flagged to dismissed or confirmed) and reviews (opened to closed), over the decisions made in the range. `actedOnAgain` counts people acted on who had been acted on within 30 days before; `bansLifted` counts the bans in the range, those at least 30 days old (`oldEnough`) and how many of those were lifted within 30 days, and the reasons given on case files lifted in the range. Needs the `ViewAnalytics` permission.