OrbTop

Discord Message Scraper

AUTOMATIONOTHER
Try on Apify

Discord Message Scraper

Extract message history and channel data from Discord servers. Returns full message content, author info, timestamps, attachments, and embeds — from a single channel or every text channel in a guild. Supports cursor-based pagination and automatic resume between runs.

Discord Message Scraper Features

  • Scrape messages from any channel your token has access to, with configurable limits
  • Bulk-scrape all text channels in a guild in a single run
  • List all channels in a guild with metadata (type, name, permissions, position)
  • Resume where you left off — cursors are saved automatically between runs, so scheduled jobs only fetch new messages
  • Paginate forward or backward through message history using before or after cursors
  • Pure API scraping — no browser, no proxies, 128MB memory default. Runs are cheap.
  • Clear error messages for invalid tokens, inaccessible channels, and rate limits — no cryptic stack traces

What Can You Do With Discord Data?

  • Community analysts — Track conversation volume, active users, and engagement patterns across channels
  • Compliance teams — Archive message history for audit trails or regulatory requirements
  • Researchers — Collect discussion data for sentiment analysis, topic modeling, or discourse studies
  • Server admins — Back up important channels before restructuring or archiving a server
  • Lead gen teams — Monitor niche Discord communities for market signals and prospect identification
  • AI/ML engineers — Build training datasets from public Discord conversations

How Discord Message Scraper Works

  1. Provide a channel ID, your Discord token, and pick an action (scrape messages, list channels, or bulk-scrape a guild).
  2. The scraper hits Discord's API directly, paginates through results, and saves a cursor so your next run picks up where this one stopped.
  3. Output lands in the Apify dataset as structured JSON — one object per message or channel.

Input

Scrape messages from a channel

{
  "action": "Scrape Messages",
  "channelId": "1206131794261315594",
  "token": "YOUR_DISCORD_TOKEN",
  "limit": 1000,
  "cursorType": "after"
}

List all channels in a guild

{
  "action": "Scrape Channel List for Guild",
  "channelId": "1206131794261315594",
  "token": "YOUR_DISCORD_TOKEN"
}

Bulk-scrape all text channels in a guild

{
  "action": "Scrape Messages for Guild",
  "channelId": "1206131794261315594",
  "token": "YOUR_DISCORD_TOKEN",
  "limit": 500
}

Scrape every thread inside a forum channel

Forum channels (Discord channel type 15) hold posts as threads, not regular messages. Point this action at the forum channel ID; the scraper lists active + archived public threads, then pulls messages from each one.

{
  "action": "Scrape Forum Channel",
  "channelId": "1206131794261315594",
  "token": "YOUR_DISCORD_TOKEN",
  "limit": 100,
  "maxThreadsPerForum": 25
}

Each output message is decorated with thread_id, thread_name, and parent_forum_id so you can group results by post or by forum without a second API call.

Field Type Required Default Description
action string Yes — "Scrape Messages", "Scrape Channel List for Guild", "Scrape Messages for Guild", or "Scrape Forum Channel"
channelId string Yes — Numeric Discord channel ID. Not a URL — find it in Discord's developer mode settings.
token string Yes — Discord user or bot token. Stored securely, never logged.
limit integer No 100 Maximum messages to fetch (per channel/thread).
cursorType string No "after" Pagination direction: "before" (older messages) or "after" (newer messages).
cursor string No null Message ID to start from. Usually handled automatically via saved cursors.
maxThreadsPerForum integer No 25 Only used by "Scrape Forum Channel". Cap on threads pulled from the forum. 0 = unlimited.

Discord Message Scraper Output Fields

Scrape Messages

Each message is a full Discord message object with all metadata intact.

{
  "id": "1168007238766559311",
  "type": 0,
  "content": "Give me a fun picture",
  "channel_id": "1143396487057899611",
  "timestamp": "2023-10-29T02:03:46.247000+00:00",
  "edited_timestamp": null,
  "author": {
    "id": "936929561302675456",
    "username": "Midjourney Bot",
    "global_name": null,
    "bot": true
  },
  "attachments": [],
  "embeds": [],
  "mentions": [],
  "mention_roles": [],
  "pinned": false,
  "tts": false,
  "flags": 0
}
Field Type Description
id string Unique message snowflake ID
content string Message text content
channel_id string Channel the message belongs to
timestamp string ISO 8601 timestamp
edited_timestamp string|null When the message was last edited, if ever
author object Author with id, username, global_name, bot flag
attachments array Files attached to the message (images, documents, etc.)
embeds array Rich embeds (links, media previews)
mentions array Users mentioned in the message
mention_roles array Roles mentioned
pinned boolean Whether the message is pinned
tts boolean Text-to-speech flag
flags integer Discord message flags bitmask

Scrape Channel List for Guild

{
  "id": "1143396487057899613",
  "type": 0,
  "name": "general",
  "guild_id": "1143396486411984942",
  "parent_id": "1143396487057899611",
  "position": 0,
  "nsfw": false,
  "rate_limit_per_user": 0,
  "permission_overwrites": []
}
Field Type Description
id string Channel snowflake ID
type integer Channel type (0 = text, 2 = voice, 4 = category, etc.)
name string Channel name
guild_id string Parent guild ID
parent_id string|null Parent category channel ID
position integer Display position in the channel list
nsfw boolean Whether the channel is marked NSFW
permission_overwrites array Permission override objects

FAQ

How do I scrape Discord messages?

Discord Message Scraper takes a channel ID and your Discord token, then fetches messages via Discord's API. Set the action to "Scrape Messages", provide the channel ID (the numeric one — right-click the channel in Discord with developer mode on), and set a limit. The scraper handles pagination automatically.

How much does Discord Message Scraper cost?

Discord Message Scraper charges $0.0003 per message scraped and $0.0003 per channel scraped. A run that fetches 1,000 messages costs about $0.30. There is no monthly fee — you pay only for what you scrape.

Can I scrape an entire Discord server?

Discord Message Scraper supports guild-wide scraping. Set the action to "Scrape Messages for Guild" and provide any channel ID from that server. The scraper discovers all text channels in the guild and fetches messages from each one, up to your configured limit per channel. Each output record is a single message (with its channel_id field intact) — flat output makes downstream processing identical to the single-channel scrape.

Can I scrape Discord forum channels?

Yes. Set the action to "Scrape Forum Channel" and pass the forum channel ID. The scraper lists every active and archived public thread under that forum, then pulls messages from each thread up to your configured limit. Use maxThreadsPerForum to cap how many posts get scraped (defaults to 25). Each output message is tagged with thread_id, thread_name, and parent_forum_id.

Does Discord Message Scraper handle pagination automatically?

Discord Message Scraper saves a cursor after every run. On the next run with the same channel ID and token, it picks up from where it left off — no manual cursor management needed. This makes it straightforward to set up scheduled runs that only fetch new messages.

What happens if my token is invalid or I don't have channel access?

Discord Message Scraper validates your input and returns clear error messages. An expired token gets "Invalid or expired Discord token." A channel you can't access gets "Access denied to channel [id]." These appear in your dataset output instead of a cryptic crash, which is more than most scrapers offer.

Need More Features?

Need date filtering, attachment downloads, or DM scraping? File an issue or get in touch.

Why Use Discord Message Scraper?

  • Pay per message — No monthly subscription. 1,000 messages cost $0.30. Scale up or down without commitment.
  • Automatic resume — Cursor management is built in. Scheduled runs fetch only new messages, which means you're not paying to re-scrape the same data.
  • Clean errors — Bad tokens and inaccessible channels return human-readable messages in your dataset, not stack traces and FAILED status codes.

Which Discord actor do I need?

  • Want to scrape messages from a channel, forum, or whole guild? You're in the right place — keep reading.
  • Want to scrape the member list of a Discord server? Use Discord Member Scraper — extracts usernames, roles, join dates, and nicknames with optional role and join-date filters.
  • Want to find Discord servers in a niche (no token needed)? Use Discord Server Directory Scraper — pulls public server listings from discord.com/servers, discord.me, and top.gg.
Try on Apify