Discord Bot Directory Scraper - top.gg and discord.bots.gg

Build one catalogue of Discord bots from top.gg and discord.bots.gg. Every row has the same shape, tagged with the directory it came from: bot name, tagline, server count, votes, certified flag, tags, owner, invite link, support server, website and GitHub.

Discord Bot Directory Scraper Features

• Two directories in one run, one row shape, source_directory on every row.
• Server counts for every bot, so you can rank the ecosystem by reach.
• Vote counts, tags and certified status from top.gg.
• Invite links, support server invites, websites and GitHub links for outreach and partnerships.
• Filter by tag (music, moderation, economy, AI and more) or return only certified and verified bots.
• Duplicates removed within a run.

Who Uses Discord Bot Directory Data?

• Bot developers benchmarking against competing bots in their category.
• Investors and analysts sizing the Discord bot ecosystem and tracking the biggest bots.
• Moderation and AI tooling vendors building a prospect list of bots and their owners.
• Directory and aggregator builders who want the listings from both sites in one feed.

How the Discord Bot Directory Scraper Works

1. Pick the directories and, optionally, one or more tags.
2. The actor walks top.gg by votes and discord.bots.gg by server count, biggest first, and stops at your maxItems.
3. Rows are written to the dataset as they are collected.

maxItems is shared evenly between the selected directories. If one directory has fewer bots than its share, the unused part goes to the other.

discord.bots.gg lists about 1,300 bots in total. top.gg is far larger.

Input

Field	Type	Description
sources	array	top.gg, discord.bots.gg, or both (default both)
tags	array	Only bots with one of these tags. On discord.bots.gg, which has no tags, the tag is used as a keyword search
certifiedOnly	boolean	Only bots certified on top.gg or verified on discord.bots.gg
maxItems	integer	Maximum bots returned across all selected directories (default 100)

Example:

{
    "sources": ["top.gg", "discord.bots.gg"],
    "tags": ["music"],
    "certifiedOnly": false,
    "maxItems": 200
}

Discord Bot Directory Scraper Output Fields

Field	Description	top.gg	discord.bots.gg
bot_id	Discord application ID	yes	yes
bot_name	Bot name	yes	yes
source_directory	top.gg or discord.bots.gg	yes	yes
tagline	Short description from the listing	yes	yes
prefix	Command prefix	yes	yes
command_count	Commands published on the listing	yes	no
server_count	Servers the bot is in	yes	yes
vote_count	Votes in the directory's current voting window	yes	no
certified	Certified on top.gg, verified on discord.bots.gg	yes	yes
tags	Tags and categories	yes	no
owner_handle	Owner or team name	some	yes
owner_id	Owner Discord ID	some	yes
support_server_invite	Support server invite link	yes	yes
invite_url	Add-to-server invite link	yes	yes
website	Bot website	yes	yes
github_url	Source code link	yes	yes
source_url	Listing page URL	yes	yes
last_updated	Last status change reported by the directory	no	yes

Fields a bot's owner left blank on the listing come back as null.

---

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, so supply it unmodified.

---

FAQ

Which Discord bot directories are covered?

top.gg and discord.bots.gg. The older discordbots.gg address no longer exists, so it is not offered.

Can I get only music bots, or only moderation bots?

Yes. Choose one or more tags. On top.gg only bots carrying the tag are returned. discord.bots.gg has no tags, so there the tag is searched as a keyword.

Does it return server counts and votes?

Server counts come from both directories. Vote counts and tags come from top.gg only.

Can I get owner and invite details?

Yes. Each row includes the invite link, support server link, website and GitHub link when the listing has them, and the owner or team name where the directory shows one.

Why is last_updated empty for top.gg rows?

top.gg does not publish a last-updated date on its listings. discord.bots.gg reports the time of the bot's last status change.

Do I need an account or API key?

No.

How much does it cost to run?

You pay per bot returned. See the pricing panel on this page for the current rate.

Need More Features?

Open an issue from the actor page with the directory or field you want added.