Bot Statistics

If you are a bot owner, you might want to POST bot statistics to our API.

  • You can post guilds, users, and voice_connections

  • The guild count is displayed on your widget and on the site.

  • User count and voice connections are exposed in the API for those who want to make cool graphs.

post
Post Stats

https://discordbotlist.com/api/v1/bots/:id/stats
This method is used to send bot statistics to Discord Bots.
Request
Response
Request
Path Parameters
id
required
string
The ID of your Discord bot.
Headers
Authorization
required
string
Authentication token
Body Parameters
voice_connections
optional
integer
The amount of voice connections.
users
optional
integer
The amount of users.
guilds
required
integer
The amount of guilds.
shard_id
optional
integer
The shard ID if you wish to send per-shard statistics. The statistics will be grouped together and displayed on the website.
Response
200: OK
{ "success": true }

‚Äč