Bots

REST API reference for routes relating to bots.

get
Get all bots

https://discordbots.fun/api/bots
Get a full list of bots listed on the website. Supports additional filters, but defaults to showing all bots, approved and unapproved.
Request
Response
Path Parameters
filter
optional
string
The filter to apply to the response. 'all', 'approved' or 'unapproved'
200: OK
{
"success": true,
"bots": [{
"approved": true,
"createdAt": 1552546571840,
"description": "YouTube brings the best of youtube.com to your Discord server, with video/playlist/channel information, trending and random videos, and more.",
"editors": [],
"id": "456633518882160642",
"invite": "https://discordapp.com/oauth2/authorize/?scope=bot&client_id=456633518882160642",
"modifiedAt": null,
"owner": "296044953576931328",
"prefix": "yt, @mention",
"serverCount": 11499,
"support": "nnprgY",
"website": null
}, ...]
}

get
Get a specific bot

https://discordbots.fun/api/bots/:id
Get a full bot from the list, including the details, bot user and owner.
Request
Response
‚Äč
200: OK
{
"success": true,
"bot": {
"approved": true,
"createdAt": 1552546571840,
"description": "YouTube brings the best of youtube.com to your Discord server, with video/playlist/channel information, trending and random videos, and more.",
"editors": [],
"id": "456633518882160642",
"invite": "https://discordapp.com/oauth2/authorize/?scope=bot&client_id=456633518882160642",
"modifiedAt": null,
"owner": "296044953576931328",
"prefix": "yt, @mention",
"serverCount": 11499,
"support": "nnprgY",
"website": null
},
"user": {
"id": "456633518882160642",
"username": "YouTube",
"discriminator": "7763",
"avatar": "8350d135051aa4fa4b0ac87d0d64f765",
"createdTimestamp": 1528940314742,
"defaultAvatarURL": "https://cdn.discordapp.com/embed/avatars/3.png",
"tag": "YouTube#7763",
"avatarURL": "https://cdn.discordapp.com/avatars/456633518882160642/8350d135051aa4fa4b0ac87d0d64f765.webp",
"displayAvatarURL": "https://cdn.discordapp.com/avatars/456633518882160642/8350d135051aa4fa4b0ac87d0d64f765.webp"
},
"owner": {
"id": "296044953576931328",
"username": "ThatTonybo",
"discriminator": "0001",
"avatar": "a_0cc37fa7310a65af497b5a1924da85f5",
"createdTimestamp": 1490653017182,
"defaultAvatarURL": "https://cdn.discordapp.com/embed/avatars/1.png",
"tag": "ThatTonybo#0001",
"avatarURL": "https://cdn.discordapp.com/avatars/296044953576931328/a_0cc37fa7310a65af497b5a1924da85f5.gif",
"displayAvatarURL": "https://cdn.discordapp.com/avatars/296044953576931328/a_0cc37fa7310a65af497b5a1924da85f5.gif"
}
}

post
Set or update server count

https://discordbots.fun/api/bots/:id
Update a bot's server count on the website. Set to '0' in the request to reset it to none.A
Request
Response
Headers
Authorization
required
string
The API key for the bot, found on the bot's API key page.
Body Parameters
serverCount
required
integer
The new server count to set to.
200: OK
{
"success": true,
"message": "'serverCount' updated to '11499'"
}
400: Bad Request
{
"success": false,
"error": "No 'serverCount' provided in the request body."
}
401: Unauthorized
{
"success": false,
"error": "The provided API key doesn't match the stored API key."
}