Discord Tools icon

Discord Tools

Discord utility tools - Message fetching, user info, and more
Join our community

Actions30

Overview

This node operation fetches detailed statistics about a Discord guild (server). It retrieves information such as the guild's ID, name, description, owner ID, member count, creation timestamp, channel counts by type (text, voice, category), total roles, total emojis, verification level, premium tier, and premium subscription count. This operation is useful for administrators or bots that need to monitor or report on the overall state and configuration of a Discord server.

Use Case Examples

  1. An admin wants to get an overview of their Discord server's size and structure, including how many text and voice channels it has, how many members are in the server, and the number of roles and emojis.
  2. A bot uses this operation to gather guild metadata for analytics or logging purposes, such as tracking premium subscription levels or verification settings.

Properties

Name Meaning
Guild ID The unique identifier of the Discord server (guild) for which statistics are being fetched.
Additional Options Optional parameters that can modify the behavior of the operation, such as including bots in message counts or filtering audit logs (not directly used in this operation).

Output

JSON

  • id - The unique ID of the guild.
  • name - The name of the guild.
  • description - The description of the guild, if any.
  • ownerId - The user ID of the guild owner.
  • memberCount - Total number of members in the guild.
  • createdTimestamp - Timestamp when the guild was created.
  • channels
    • total - Total number of channels in the guild.
    • text - Number of text channels in the guild.
    • voice - Number of voice channels in the guild.
    • category - Number of category channels in the guild.
  • roles
    • total - Total number of roles in the guild.
  • emojis
    • total - Total number of emojis in the guild.
  • verificationLevel - The verification level setting of the guild.
  • premiumTier - The premium tier (boost level) of the guild.
  • premiumSubscriptionCount - Number of premium subscriptions (boosts) the guild has.

Dependencies

  • Discord API access via a bot token credential

Troubleshooting

  • Ensure the provided Guild ID is correct and the bot has permission to access the guild.
  • If the node throws an error about fetching the guild or channels, verify the bot token is valid and has the necessary permissions.
  • The operation may fail if the Discord API rate limits are exceeded; consider adding retry logic or reducing request frequency.

Links

Discussion