Navigation Menu

Skip to content

Top-gg-Community/python-sdk

Repository files navigation

Top.gg Python Library

View on PyPi

v1.0.0

Documentation Status

A simple API wrapper for Top.gg written in Python, supporting discord.py.

Installation

Install via pip (recommended)

pip3 install topggpy

Install from source

pip3 install git+https://github.com/top-gg/python-sdk/

Documentation

Documentation can be found here

Features

  • POST server count
  • GET bot info, server count, upvote info
  • GET all bots
  • 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.

Examples

For examples, follow the link here