Bots

get
Bots

https://api.botlist.space/v1/bots
Retrieves all the bots listed on the site in a giant array.
Request
Response
200: OK
[
{ ... },
{ ... },
{ ... }
...
]

get
Bot by ID

https://api.botlist.space/v1/bots/:id
Gets a specific bot by an ID.
Request
Response
Path Parameters
id
required
string
The ID of the bot you want to retrieve.
200: OK
{
"success": true, // Boolean
"id": "228537642583588864", // String
"username": "Vexera", // String
"discriminator": "8487", // String
"avatar": "ec03708098c25eb4df4b1d3b1baefcc9", // String
"short_description": "Music. Moderation. Pointless Commands. 24/7 Uptime. It just works. https://vexera.io", // String
"full_description": "...", // ?String
"prefix": "+", // String
"library": "Eris", // String
"approved": true, // Boolean
"certified": true, // Boolean
"avatar_child_friendly": true, // Boolean
"links": { // Object
"invite": "https://discordapp.com/oauth2/authorize?client_id=228537642583588864&scope=bot&permissions=8", // String
"support": null // ?String
},
"owners": [ // Array<Object>
{
"id": "149505704569339904", // String
"username": "luke", // String
"discriminator": "0123", // String
"avatar": "https://cdn.discordapp.com/avatars/149505704569339904/d7083005cb77b45b55d82a4e1fbe104c.png?size=256", // String
"short_description": null // ?String
}
],
"tags": [ // ??Array<String>
"Utility"
],
"server_count": 2500, // ?Number
"shards": [ // ??Array<Number>
1250,
1250
]
"vanity": "vexera" // ?String
"created_at": 1509302556022, // Number
"updated_at": 1546153941801, // Number
}
404: Not Found
{
"success": false, // Boolean
"code": 404, // Number
"message": "Bot not found" // String
}

post
Server Count

https://api.botlist.space/v1/bots/:id
Posts server count to your bot on the site.
Request
Response
Path Parameters
id
required
string
The ID of the bot you are posting server count to.
Headers
Content-Type
required
string
Required to be set to "application/json".
Authorization
required
string
API bot token
Body Parameters
shards
optional
array
An array of numbers, each number represents the amount of servers in each of your shards. If you leave this out, the server_count parameter is required. You cannot provide both. Set to null to unset your shards count.
server_count
optional
number
The amount of servers that your bot has. If you leave this out, the shards parameter is required. You cannot provide both. Set to null to unset your server count.
200: OK
{
"success": true, // Boolean
"code": 200, // Number
"message": "Successfully updated server count" // String
}
400: Bad Request
{
"success": false, // Boolean
"code": 400, // Number
"message": "Missing server_count or shards property from body" // String
}
// OR
{
"success": false, // Boolean
"code": 400, // Number
"message": "Property server_count must be a valid number" // String
}
// OR
{
"success": false, // Boolean
"code": 400, // Number
"message": "Property server_count is too small" // String
}
// OR
{
"success": false, // Boolean
"code": 400, // Number
"message": "Property server_count is too big" // String
}
// OR
{
"success": false, // Boolean
"code": 400, // Number
"message": "One of the shards has an invalid value" // String
}
// OR
{
"success": false, // Boolean
"code": 400, // Number
"message": "One of the shards has too small of a count" // String
}
// OR
{
"success": false, // Boolean
"code": 400, // Number
"message": "One of the shards has too big of a count" // String
}
401: Unauthorized
{
"success": false, // Boolean
"code": 401, // Number
"message": "Missing Authorization header" // String
}
403: Forbidden
{
"success": false, // Boolean
"code": 403, // Number
"message": "The provided authorization does not match the requested bot's token" // String
}
404: Not Found
{
"success": false, // Boolean
"code": 404, // Number
"message": "Bot not found" // String
}

get
Bot Upvotes

https://api.botlist.space/v1/bots/:id/upvotes
Returns everyone who has upvoted the bot in the month.
Request
Response
Path Parameters
id
required
string
The ID of the bot you want to retrieve upvotes from.
Headers
Authorization
required
string
API bot token
200: OK
[ // ??Array<Object>
{
"user": {
"id": "507329700402561045", // String
"username": "PassTheMayo", // String
"discriminator": "1281", // String
"avatar": "6c1dbec73fd887f0b2e6f29e4e9091a6", // String
"short_description": "..." // ?String
},
"timestamp": 1546208945017 // Number
},
...
]
401: Unauthorized
{
"success": false, // Boolean
"code": 401, // Number
"message": "Missing Authorization header" // String
}
403: Forbidden
{
"success": false, // Boolean
"code": 403, // Number
"message": "The provided authorization does not match the requested bot's token" // String
}
404: Not Found
{
"success": false, // Boolean
"code": 404, // Number
"message": "Bot not found" // String
}

get
Bot Uptime

https://api.botlist.space/v1/bots/:id/uptime
Get the uptime of the bot in the Discord server.
Request
Response
Path Parameters
id
required
string
The ID of the bot you want to retrieve the uptime from.
200: OK
{
"success": true, // Boolean
"bot": "155149108183695360", // String
"online_checks": 7881, // Number
"total_checks": 7960, // Number
"percent": 0.9900753768844222 // Number
}
404: Not Found
{
"success": false, // Boolean
"code": 404, // Number
"message": "Bot not found" // String
}