Discord Server Directory Scraper

Scrape public Discord server listings from multiple directories -- no Discord token required. Extracts server names, descriptions, member counts, categories, invite links, and more from discord.com/servers, discord.me, and top.gg.

What data does it extract?

Field	Description	discord.com	discord.me	top.gg
server_name	Server name	Y	Y	Y
server_description	Description text	Y	Y	Y
server_id	Discord guild snowflake ID	Y	-	Y
member_count	Approximate total members	Y	-	Y
online_count	Approximate online members	Y	-	-
category_tags	Category / tag labels	Y	Y	Y
language	Server locale (e.g. en-US)	Y	-	-
invite_url	Join link	Y	Y	Y
icon_url	Server icon image URL	Y	Y	Y
banner_url	Server banner image URL	Y	Y	-
splash_url	Server discovery splash image URL	Y	-	-
vanity_url_code	Server's custom vanity invite slug	Y	-	-
boost_level	Nitro boost count	Y	-	-
verification_level	VERIFIED, COMMUNITY, etc.	Y	-	-
nsfw	NSFW flag	Y	-	Y
keywords	Server keywords / search tags	Y	Y	Y
votes	Community votes (top.gg only)	-	-	Y
source	Which directory the listing came from	Y	Y	Y
source_url	Direct link to the listing page	Y	Y	Y

Input options

• Search Query -- Optional keyword to filter results (e.g. "gaming", "crypto", "anime")
• Category -- Filter by discord.com category (Gaming, Entertainment, Education, Music, Science & Tech)
• Sources -- Which directories to scrape. Defaults to discord.com. Select multiple for broader coverage.
• Max Items -- Maximum number of servers to return (default: 50)

How it works

The scraper fetches publicly accessible directory pages from each selected source and extracts server data:

1. discord.com/servers -- Supports keyword search and category filtering, and returns the richest data: member counts, boost levels and verification status. 12 servers per page, paginated automatically.

2. discord.me -- Scrapes HTML server cards using CSS selectors. Limited data (no member counts or server IDs) but covers servers not listed on discord.com. 60+ servers per page.

3. top.gg -- Parses Next.js SSR data from the page. Includes vote counts and review scores. Tag-based browsing.

No Discord bot token or user token is required. All data comes from publicly accessible web pages.

Resuming a large crawl

Every run emits a resumeCursor in its Output. If a large crawl stops before it finishes — because it hit maxItems, your spend cap (maxTotalChargeUsd), or was aborted — start a new run with the same input plus that resumeCursor to continue from where it left off. The crawl resumes from the queued work the previous run didn't reach.

• You are not re-charged for records the earlier run already delivered.
• Resume within your account's run-retention window — on the free tier, roughly your 10 most recent runs. Once the source run is pruned, its resumeCursor is no longer valid.
• resumeCursor is opaque — supply it unmodified.

Example output

{
  "server_name": "Midjourney",
  "server_description": "The official server for Midjourney, a text-to-image AI where your imagination is the only limit.",
  "server_id": "662267976984297473",
  "member_count": 19247337,
  "online_count": 848731,
  "category_tags": ["Entertainment"],
  "language": "en-US",
  "invite_url": "https://discord.gg/midjourney",
  "icon_url": "https://cdn.discordapp.com/icons/662267976984297473/39128f6c9fc33f4c95a27d4c601ad7db.png?size=256",
  "banner_url": "https://cdn.discordapp.com/banners/662267976984297473/63249e6867f276efc07d32793b7b3b5a.webp?size=480",
  "splash_url": "https://cdn.discordapp.com/discovery-splashes/662267976984297473/4798759e115d2500fef16347d578729a.jpg?size=2048",
  "vanity_url_code": "midjourney",
  "boost_level": 305,
  "verification_level": "COMMUNITY, DISCOVERABLE, VERIFIED",
  "nsfw": false,
  "source": "discord.com",
  "source_url": "https://discord.com/servers/midjourney-662267976984297473",
  "keywords": ["AI", "artificial intelligence", "art", "creativity", "future"],
  "votes": 0
}

Use cases

• Market research -- Discover Discord communities in specific niches
• Competitor analysis -- Track server sizes and growth across categories
• Community discovery -- Find relevant servers for outreach or partnerships
• Data analysis -- Build datasets of Discord server metadata for research

Pricing

This actor uses pay-per-event pricing:

• $0.10 per actor start
• $0.001 per server record scraped

Need more features?

If you need additional data fields, new directory sources, or a custom scraper, file an issue or get in touch. We are always open to customizing the scraper for your needs.

Which Discord actor do I need?

• Want to find Discord servers in a niche (no token needed)? You're in the right place -- keep reading.
• Want to scrape messages from a channel, forum, or whole guild? Use Discord Message Scraper -- pulls messages from text channels, forum threads, or every channel in a guild with cursor-based resume (token required).
• Want to scrape the member list of a server? Use Discord Member Scraper -- extracts usernames, roles, join dates, and nicknames with optional role and join-date filters (token required).