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.

{"message":"Bot not found."}

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.

{"message":"Invalid authorization token."}

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

{"message":"Bot not found."}

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.

{"message":"Bot not found."}

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.

//You did not provide any bot token:
{ message: 'Authorization is required.' }

//You did not provide any server count:
{ message: 'Server count is required.' }

//The server count you provided was not a valid number:
{ message: 'Server count must be a valid number.' }

//The token you provided does not match the bot's token:
{ message: 'Invalid authorization token.' }

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

{ message: 'Invalid bot.' }