Skip to main content

A simple API wrapper for written in Python.

Project description


Warning: has been deprecated

Please consider using instead which is also available on PyPi.

A simple API wrapper for written in Python.


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):

Discussion, Support and Issues

For general support and discussion of this project, please join the Discord server:
Discord Server

To check known bugs and see planned changes and features for this project, please see the GitHub issues.
Found a bug we don't already have an issue for? Please report it in a new GitHub issue with as much detail as you can!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution (18.7 kB view hashes)

Uploaded source

Built Distributions (8.7 kB view hashes)

Uploaded 3 6 (8.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page