Bots

Bot

GET https://discords.com/bots/api/bot/:id

Path Parameters

Name	Type	Description
id	integer	The ID of the bot you are requesting information about.

200 The website was successfully able to fetch information about the bot.

The content of this response varies.

404 The bot you requested is not listed on the website.

Votes

GET https://discords.com/bots/api/bot/:id/votes

Path Parameters

Name	Type	Description
id	integer	The ID of the bot you are requesting voting information on.

Headers

Name	Type	Description
Authorization	string	The bot's API token.
Content-Type	string	This should be set to application/json

200 The website was successfully able to fetch information about the bot.

{
    "hasVoted": [],
    "hasVoted24": [],
    "votes": 0,
    "votes24": 0,
    "votesMonth": 0
}

400 You provided the wrong API token for the bot.

404 The bot you requested is not listed on the website.

Widget

GET https://discords.com/bots/api/bot/:id/widget

Path Parameters

Name	Type	Description
id	integer	The ID of the bot you are requesting information on.

Query Parameters

Name	Type	Description
theme	string	Set this to dark for a dark themed widget
width	number	Set the width of the widget

200 The website was successfully able to fetch and display the bot's widget.

The content of this response varies.

404 The bot you requested is not listed on the website.

Server Count

POST https://discords.com/bots/api/bot/:id

Path Parameters

Name	Type	Description
id	integer	The ID of the bot you are posting information about.

Headers

Name	Type	Description
Authorization	string	The bot's API token.

Request Body

Name	Type	Description
server_count	number	The server count for the bot.

200 Server count was successfully received and updated.

{ message: 'Server count successfully updated.' }

400 You may receive one of the following 400 errors depending on your situation.

404 The bot you are trying to post information on is not listed.