discord-bot-api

title	Discord Bot API Integration
name	discord-bot-api
description	Extract server data, channels, roles, members, and messages via Discord Bot API. Authentication, endpoints, filtering patterns.
trigger	When the user asks to: - "scan/scrape/crawl discord server" - "get discord messages" - "extract server data" - "analyze discord members/channels" - "query discord bot api" - "get user messages from discord" - Any Discord data extraction task using bot token
related	["xurl (X/Twitter API)","native-mcp (API patterns)"]
internal_context	Discord Bot API provides REST endpoints for server data extraction. Requires bot token with appropriate permissions. Rate limits: 5 requests per second per route.
external_context	https://discord.com/developers/docs/reference https://discord.com/developers/docs/resources/guild https://discord.com/developers/docs/resources/channel

Discord Bot API Integration

Use Discord Bot API to extract server information, channels, roles, members, and messages.

Prerequisites

1. Bot Token - Get from Discord Developer Portal → Applications → Bot → Token
2. Bot Permissions - Bot must be added to target server with appropriate scopes:
   • guilds - Read server info
   • guilds.members.read - Read member list
   • messages.read - Read message history

Authentication

export BOT_TOKEN="YOUR_BOT_TOKEN_HERE"

# Verify bot identity
curl -s -H "Authorization: Bot $BOT_TOKEN" https://discord.com/api/v10/users/@me | jq .

Common Workflows

1. List Servers (Guilds)

curl -s -H "Authorization: Bot $BOT_TOKEN" \
  "https://discord.com/api/v10/users/@me/guilds" | jq .

Returns: Array of guild objects with id, name, permissions

2. Get Server Details

GUILD_ID="1092673756457074760"
curl -s -H "Authorization: Bot $BOT_TOKEN" \
  "https://discord.com/api/v10/guilds/$GUILD_ID?with_counts=true" | jq .

Returns: Guild object with member counts, roles, emojis, features

3. List Channels

curl -s -H "Authorization: Bot $BOT_TOKEN" \
  "https://discord.com/api/v10/guilds/$GUILD_ID/channels" | jq .

Returns: Array of channel objects. Type 0 = text, 4 = category

4. Get Members

curl -s -H "Authorization: Bot $BOT_TOKEN" \
  "https://discord.com/api/v10/guilds/$GUILD_ID/members?limit=100" | jq .

Returns: Array of member objects with user info, roles, join date

5. Get Messages from Channel

CHANNEL_ID="1092673756457074763"
curl -s -H "Authorization: Bot $BOT_TOKEN" \
  "https://discord.com/api/v10/channels/$CHANNEL_ID/messages?limit=50" | jq .

Returns: Array of message objects (newest first)

6. Filter Messages by User

USER_ID="736414400201752686"
curl -s -H "Authorization: Bot $BOT_TOKEN" \
  "https://discord.com/api/v10/channels/$CHANNEL_ID/messages?limit=100" | \
  jq -r --arg UID "$USER_ID" '.[] | select(.author.id == $UID) | "[\(.timestamp)] \(.content)"'

Data Structure

Member Object

{
  "user": {
    "id": "...",
    "username": "...",
    "global_name": "...",
    "avatar": "..."
  },
  "nick": "display name",
  "roles": ["role_id_1", "role_id_2"],
  "joined_at": "2023-04-05T08:03:04.259000+00:00"
}

Message Object

{
  "id": "...",
  "author": {
    "id": "...",
    "username": "..."
  },
  "content": "message text",
  "timestamp": "2026-05-07T03:28:35.799000+00:00"
}

Pitfalls

• 401 Unauthorized - Token invalid or expired. Reset in Developer Portal.
• 403 Forbidden - Bot lacks permissions for that endpoint
• Rate Limiting - 5 req/sec. Add delays for bulk operations
• Member Limit - /members returns max 1000. Use pagination with after parameter
• Message History - Requires MESSAGE_CONTENT intent enabled in Developer Portal

Output Format

Save extracted data to Obsidian in structured markdown:

• Server-Overview.md - Guild info, structure, stats
• Team-Directory.md - Members, roles, departments
• {Username}-Activity.md - Message history per user