An alternative wrapper for the top.gg API
Please note, this is not an official package from top.gg. We are not affiliated with top.gg in any way. If you want to install their official package, please see their repo.
Warning! top.py is not tested to be compatible with discord.py forks, or any other library than the official discord.py library. If you encounter issues when using another library, please open an issue with as much detail and support will be added.
top.py is a python wrapper for the top.gg discord bot list API. top.py aims to be object-oriented, whereas the official top.gg python SDK is more low-level raw data.
You can install the latest stable release here:
pip install top.pyBut, if you're reading this, you're most likely a developer - you should know how to install packages by now.
You can see examples in the examples.md file.
| Feature Name | Supported? |
|---|---|
| Automatic posting of server count | ✅ |
| Searching/Bulk Querying Bots | ✅ |
| Fetching a bot | ✅ |
| Fetching a user | ✅ |
| Fetching last 1000 upvotes | ✅ |
| Fetching a bot's stats | ✅ |
| Checking individual user vote | ✅ |
| Manual posting server count | ✅ |
| Models for all individual endpoints | ✅ |
| In-house ratelimiting | ✅ |
| Vote Webhooks | ✅ |
| Making you a nice slice of toast | ❌ |
NOTE: We do NOT currently provide official support for discord server list. That's coming soon.
- Object-Oriented (No-more shall you faff about with dictionaries)
- Sensible function names & arguments
support (or mention @eek#7574 in top.gg) | docs | PyPi | examples | (META) Code Of Conduct | (META) Contributing Guidelines