Skip to main content

Python Library

The community-maintained Python Library for, if you experience any issues please submit an issue on our github.


$ pip install topggpy


Documentation can be found here.


  • POST server count
  • GET bot info, server count, upvote info
  • GET user info
  • GET widgets (large and small) including custom ones. See for more info.
  • GET weekend status
  • Built-in webhook to handle votes
  • Automated server count posting
  • Searching for bots via the API

Additional information

  • Before using the webhook provided by this library, make sure that you have specified port open.
  • Optimal values for port are between 1024 and 49151.
  • If you happen to need help implementing topggpy in your bot, feel free to ask in the #development or #api channels in our Discord server