A simple API wrapper for written in Python.

api wrapper discord bot bots stats statistics, api-wrapper, discord, discord-api, discord-bot, discord-py, python, python-3, python-3-5, python-3-6, python-module, python3, python35, python36, statistics, stats, stats-api, wrapper, wrapper-library
pip install



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!