Bots

Routes used to preform actions on a specific bot, or get all the bots on the list.

get
Get all bots

https://discordsbestbots.xyz/api/bots
Request
Response
Query Parameters
tags
optional
string
Tags to search for when getting bots. Separate with a comma.
delete
optional
string
Delete specific properties from a bot, separate with a comma. Like RethinkDB's without method.
filters
optional
string
The filters to apply when getting bots separate by comma. You can choose from: verified, trusted, has-status, status-online, status-idle, status-dnd, status-offline, shuffle, reversed, votes-ascending, votes-descending, total-votes-ascending, total-votes-descending, monthly-votes-ascending, monthly-votes-descending. If you provide an invalid filter, the bot array (no filters) will be returned.
200: OK
{
"error": false,
"bots": [...Bot objects (owner, and owners are strings)]
}

get
Get a bot

https://discordsbestbots.xyz/api/bots/:id
Gets a bot.
Request
Response
Path Parameters
id
optional
string
The id to use. If trusted use the vanity URL, else use the id.
Headers
Authorization
optional
string
The users JWT.
Query Parameters
markdown
optional
boolean
Whether the full description should be marked down.
200: OK
The bot was found
{
"error": false,
"bot": {
"_id": "459153545917235200",
"addedAt": 1546241075937,
"bg": "",
"color": "#3C393A",
"fullDesc": "<h1 id=\"oh\">Oh</h1>\n<ul>\n<li>hi</li>\n<li>yes</li>\n</ul>\n<style>\n div.hero-body { background: transparent !important; }\n code { color: #CEC568 !important; }\n span.tag.is-warning { background-color: #CEC568 !important; }\n div.tile.is-child.notification.is-success { background-color: #3C393A !important; }\n div.tile.is-child.notification.is-primary { background-color: #201C1E !important; }\n div.tile.is-child.notification.is-info { background-color: #101010 !important; }\n div.tile.is-child.notification.is-dark { background-color: #3C393A !important; }\n div.tile.is-child.notification.is-dark.has-text-left.content { background-color: #201C1E !important; }\n div.tile.is-child.notification.is-link { background-color: #201C1E !important; }\n @keyframes pulse {\n 0% { -moz-box-shadow: 0 #3C393A; box-shadow: 0 0 0 #3C393A; }\n 50% { -moz-box-shadow: 0 #3C393A; box-shadow: 0 0 0 25px rgba(25, 118, 210, 0); }\n 100% { -moz-box-shadow: rgba(255, 255, 255, 0); box-shadow: 0 0 0 rgba(255, 255, 255, 0); }\n }\n @keyframes moveAvatar {\n 0% { transform: translateY(0px); }\n 100% { transform: translateY(-10px); }\n }\n img#botAvatar { animation: pulse 4s infinite, moveAvatar 2s infinite alternate-reverse; }\n iframe#site {\n width: 100% !important;\n height: 800px !important;\n }\n</style>\n<h1 id=\"websiteHeader\">Website:</h1>\n<iframe id=\"site\" src=\"https://remixbot.ml\"></iframe>",
"github": "",
"hi": true,
"invite": "",
"lang": "discord.js",
"monthlyVotes": 6,
"nsfw": false,
"owner": {
"user": {
"username": "Ice",
"discriminator": "4710",
"id": "302604426781261824",
"displayAvatarURL": "https://cdn.discordapp.com/avatars/302604426781261824/a_249bc5fedc1fe8686936f61938f528f7.gif?size=128",
"bot": false
},
"status": "dnd",
"id": "302604426781261824",
"trustedDev": true,
"mod": true,
"admin": true,
"hideNsfw": false
},
"owners": [],
"prefix": "cn. (changeable)",
"server": null,
"shortDesc": "Yes",
"stats": {
"guilds": 90,
"shards": 0
},
"tags": [
"Music",
"Fun",
"Dashboard"
],
"totalVotes": 6,
"trusted": true,
"twitter": "",
"vanityUrl": "cnn",
"verified": true,
"votes": [
"302604426781261824",
"201084449797046273"
],
"website": "https://remixbot.ml",
"member": {
"user": {
"username": "Chat Noir",
"discriminator": "9924",
"id": "459153545917235200",
"displayAvatarURL": "https://cdn.discordapp.com/avatars/459153545917235200/c588678a9c60e11dcca4c728ebf4ccfe.jpg?size=128",
"bot": true
},
"status": "online"
},
"inGuild": true
}
}
403: Forbidden
Your Authorization header was bad.
{
"error": true,
"errors": [
"Unauthorized"
]
}
404: Not Found
The bot wasn't found.
{
"error": true,
"errors": [
"The requested resource was not found on this server"
]
}

get
Get Audit Logs

https://discordsbestbots.xyz/api/bots/:id/logs
Get the audit logs for a bot.
Request
Response
Path Parameters
id
required
string
The id to use. If trusted, use the vanity URL, else the id.
Headers
Authorization
required
string
The users JWT.
200: OK
Successfully retrieved the audit logs.
{
"error": false,
"bot": {
"member": {
"user": {
"username": "Chat Noir",
"discriminator": "9924",
"id": "459153545917235200",
"displayAvatarURL": "https://cdn.discordapp.com/avatars/459153545917235200/c588678a9c60e11dcca4c728ebf4ccfe.jpg?size=128",
"bot": true
},
"status": "online"
}
},
"log": [
// Entry
{
"action": string,
"user"?: string | object,
"actionPreformedAt": number,
"data"?: any
}
]
}
401: Unauthorized
You're unauthorized.
{
"error": true,
"errors": [
"Authorization header missing"
]
}
403: Forbidden
Your Authorization header was invalid.
{
"error": true,
"errors": [
"Invalid token passed"
]
}
404: Not Found
The bot wasn't found.
{
"error": true,
"errors": [
"Authorization header missing"
]
}

get
Get hidden info

https://discordsbestbots.xyz/api/bots/:id
Get the hidden information of a bot.
Request
Response
Path Parameters
id
required
string
The id to use. If trusted, use the vanity URL, else the id.
200: OK
The hidden info was retrieved.
{
"error": false,
"_id": "cnn",
"apiKey": "...",
"webhook": {
"auth": "",
"url": ""
},
"owner": "302604426781261824",
"owners": [],
"lastStatsUpdate": 1546923940397
}
401: Unauthorized
No authorization header was found.
{
"error": true,
"errors": [
"Authorization header missing"
]
}
403: Forbidden
Your authorization header was invalid.
{
"error": true,
"errors": [
"Invalid token passed"
]
}
404: Not Found
The bot wasn't found
{
"error": true,
"errors": [
"The requested resource was not found on this server"
]
}

get
Vote check

https://discordsbestbots.xyz/api/voted/:id
Check who has voted for your bot
Request
Response
Path Parameters
id
required
string
The id to use. If trusted, use the vanity URL, else use the id.
Headers
Authorizaiton
required
string
Your bots API key.
Query Parameters
user
required
string
The id to check.
200: OK
Successfully checked the vote
{
"error": false,
"voted": true
}
401: Unauthorized
No authorization header was supplied
{
"error": true,
"errors": [
"Authorization header missing"
]
}
403: Forbidden
The authorization header was invalid.
{
"error": true,
"errors": [
"Invalid token passed"
]
}
404: Not Found
Unknown bot
{
"error": true,
"errors": [
"Not found"
]
}

get
Votes

https://discordsbestbots.xyz/api/bots/:id/votes
Request
Response
Path Parameters
id
required
string
The id to use. If trusted, use the vanity url, else use the bot id.
200: OK
Successfully retrieved the bots votes.
{
"error": false,
"votes": [
{
"bot": "459153545917235200",
"type": "vote",
"votedAt": 1550208335348,
"voter": "302604426781261824"
},
{
"bot": "459153545917235200",
"type": "vote",
"votedAt": 1550733338952,
"voter": "201084449797046273"
}
]
}
401: Unauthorized
Your authorization header was bad.
{
"error": true,
"errors": [
"Authorization header missing"
]
}
403: Forbidden
The API key was invalid.
{
"error": true,
"errors": [
"Invalid token passed"
]
}
404: Not Found
The bot wasn't found.
{
"error": true,
"errors": [
"Not found"
]
}