Skip to main content

Python Library

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

Installation

$ pip install topggpy

Documentation

Documentation can be found here.

Features

  • POST server count
  • GET bot info, server count, upvote info
  • GET user info
  • GET widgets (large and small) including custom ones. See docs.top.gg for more info.
  • GET weekend status
  • Built-in webhook to handle Top.gg 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