Statistics

Channel activity

GET/v1/guilds/:guildId/stats/channels

NeedsOwner's keynyx+stats:read

Channels ranked by activity over the range, busiest first: messages sent and minutes spent in voice. Channels with no activity in the range are left out.

Days are UTC calendar days, and from and to are both inclusive. The response echoes the range nyx actually applied, which can be narrower than the one asked for when it reaches past the history nyx keeps.

Messages in a thread count toward the channel the thread lives in. name is the channel's current name, or null once it has been deleted. type is one of text, voice, announcement, thread, forum, stage or other.

Query parameters

fromdate: First day, inclusive, in UTC. Defaults to 29 days before to, so the default range is 30 days.
todate: Last day, inclusive, in UTC. Defaults to today. The range may span at most 365 days.
limitinteger · 1 to 100 · default 25: How many channels to return, from 1 to 100.

Errors

400 BAD_REQUEST when:

from or to is not a real date in YYYY-MM-DD form.
from is after to.
The range spans more than 365 days, counting both ends.
limit is not a whole number from 1 to 100.

Plus the failures every endpoint shares, listed under errors & limits.

Request

$ curl "https://api.nyx.cool/v1/guilds/1467281625954914369/stats/channels?limit=3" \
    -H "Authorization: Bearer nyx_live_..."

Response200

{
  "guildId": "1467281625954914369",
  "from": "2026-09-05",
  "to": "2026-10-04",
  "channels": [
    {
      "channelId": "1467281626626003065",
      "name": "general",
      "type": "text",
      "messages": 8412,
      "voiceMinutes": 0
    },
    {
      "channelId": "1467281626626003066",
      "name": "Lounge",
      "type": "voice",
      "messages": 2240,
      "voiceMinutes": 6180
    },
    {
      "channelId": "1467281626626003068",
      "name": "memes",
      "type": "text",
      "messages": 1950,
      "voiceMinutes": 0
    }
  ]
}

Response400

{
  "code": "BAD_REQUEST",
  "message": "limit must be a whole number from 1 to 100"
}