Bots

get
Bot

https://api.botsdatabase.com/v1/bots/:id
Gather information about a specific bot.
Request
Response
Request
Path Parameters
ID
required
string
ID of the bot you are looking for.
Response
200: OK
The content of this response varies.
404: Not Found
{
'error': {
'status': 404,
'message': 'The bot you are looking for does not exist on our website.'
}
}

get
Bot votes

https://api.botsdatabase.com/v1/bots/:id/votes
Gather the people who voted for the bot during the current month.
Request
Response
Request
Path Parameters
ID
required
string
ID of the bot you are looking for.
Headers
Authorization
required
string
The bot's API token.
Response
200: OK
[
{
'user': {
'id': '576521138725715969',
'username': 'BotsDataBase',
'discriminator': '3364'
},
"timestamp": 1583561299249
},
{
'user': {
'id': '576521138725715969',
'username': 'BotsDataBase',
'discriminator': '4464'
},
"timestamp": 1596994075257
}
]
401: Unauthorized
{
'error': {
'status': 401,
'message': 'Missing "Authorization" header'
}
}
403: Forbidden
{
'error': {
'status': 403,
'message': 'An invalid Authorization token was provided.'
}
}
404: Not Found
{
'error': {
'status': 404,
'message': 'The bot you are looking for does not exist on our website.'
}
}
429: Too Many Requests
{
'error': {
'status': 429,
'message': 'Too many requests, please you need to slow down.'
}
}

post
Bot stats

https://api.botsdatabase.com/v1/bots/:id
Update your bot's statistics on our website.
Request
Response
Request
Path Parameters
ID
required
string
ID of the bot you are posting stats on.
Headers
Authorization
required
string
The bot's API token.
Content-Type
required
string
application/json
Body Parameters
servers
optional
string
The amount of servers the bot is in.
shards
optional
string
An array of numbers containing the amount of servers the bot is in per shard.
Response
200: OK
{
'success': true,
'status': 200,
'message': 'Successfully updated your bot stats.'
}
400: Bad Request
{
'error': {
'status': 400,
'message': 'The Content-Type header must be set to "application/json".'
}
}
/* --------- */
{
'error': {
'status': 400,
'message': 'Invalid JSON: body data is invalid or corrupted.'
}
}
/* --------- */
{
'error': {
'status': 400,
'message': 'Missing "servers" or "shards" property from body.'
}
}
/* --------- */
{
'error': {
'status': 400,
'message': 'The field "servers" must be a number.'
}
}
/* --------- */
{
'error': {
'status': 400,
'message': 'The field "servers" must be a number greater than 1.'
}
}
/* --------- */
{
'error': {
'status': 400,
'message': 'The field "servers" must be a number less than 5900000.'
}
}
/* --------- */
{
'error': {
'status': 400,
'message': 'One of the shard data in the "shards" field is not correct.'
}
}
/* --------- */
{
'error': {
'status': 400,
'message': 'One of the shards contains a server count less than 1.'
}
}
/* --------- */
{
'error': {
'status': 400,
'message': 'One of the shards contains a server count greater than 3000.'
}
}
/* --------- */
{
'error': {
'status': 400,
'message': 'The field "shards" must be an Array or a null value.'
}
}
/* --------- */
{
'error': {
'status': 400,
'message': 'Invalid JSON: body data is invalid or corrupted.'
}
}
401: Unauthorized
{
'error': {
'status': 401,
'message': 'Missing "Authorization" header'
}
}
403: Forbidden
{
'error': {
'status': 403,
'message': 'An invalid Authorization token was provided.'
}
}
404: Not Found
{
'error': {
'status': 404,
'message': 'The bot you are looking for does not exist on our website.'
}
}
429: Too Many Requests
{
'error': {
'status': 429,
'message': 'Too many requests, please you need to slow down.'
}
}
500: Internal Server Error
{
'error': {
'status': 500,
'message': 'An internal server error occurred.'
}
}