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 Stats

POST https://discordbotlist.com/api/v1/bots/:id/stats

This method is used to send bot statistics to Discord Bots.

Path Parameters

Name
Type
Description

id

string

The ID of your Discord bot.

Headers

Name
Type
Description

Authorization

string

Authentication token

Request Body

Name
Type
Description

voice_connections

integer

The amount of voice connections.

users

integer

The amount of users.

guilds

integer

The amount of guilds.

shard_id

integer

The shard ID if you wish to send per-shard statistics. The statistics will be grouped together and displayed on the website.

{ "success": true }

Last updated