Skip to content
A simple API wrapper for written in Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Warning: has been deprecated

Please consider using instead, this supports BFD as well as all other bot lists in a single module. It is also available on PyPi.

A simple API wrapper for written in Python.

PyPi Version Slack


Install via pip (recommended)

pip install


  • POST server count
  • AUTOMATIC server count updating
  • GET bot info
  • GET global bot list
  • GET bot list for a specific user
  • GET widgets url
  • SEARCH for bots

Example Rewrite cog

    import bfd
    import discord
    from discord.ext import commands

    class BotsForDiscord:
        def __init__(self, bot):
   = bot
            self.token = 'token'  # set this to your BFD token
            self.bfd = bfd.Client(, self.token)  # Create a Client instance
            self.bfd.start_loop()  # Posts the server count every 30 minutes

        async def botinfo(self, ctx, bot: discord.User): # unfiltered botinfo demo
            info = await self.bfd.get_bot(
            if info is None:
                await ctx.send("Can't find this bot on BFD")

            embed = discord.Embed(title="BotInfo")
            for key, value in info.as_dict().items():
                if key == "" or value == "":

                embed.add_field(name=key, value=str(value))

            await ctx.send(embed=embed)

    def setup(bot):


Contributions are always welcome to this project!
Take a look at any existing issues on this repository for starting places to help contribute towards, or simply create your own new contribution to the project.

Please make sure to follow the existing standards within the project such as code styles, naming conventions and commenting/documentation.

When you are ready, simply create a pull request for your contribution and I will review it whenever I can!

Need to chat about the project and how you can get involved?
Join the Slack workspace to find the appropriate channel, talk to other contributors and myself:

Discussion, Support and Issues

Need support with this project or have found an issue?

Please check the project's issues page first!

Not found what you need?

  • Create a GitHub issue here to report the situation, as much detail as you can!
  • or, You can join our Slack workspace to discuss the issue or to get support for the project:
You can’t perform that action at this time.