API Docs

get
Bot Info

https://bots.discordlabs.org/v2/bot/:ID
This endpoint allows you to get info on a bot listed on Discord Bot Labs.
Request
Response
Request
Path Parameters
id
required
number
ID of the bot you are searching for.
Response
200: OK
Bot Info successfully retrieved.
{
"error": "false",
"name": "Bot's Name",
"avatar": "Bot's Avatar",
"sdescription": "Bot's Short Description",
"ldescription": "Bot's Long Description",
"votes":"Amount Of Votes Bot Has",
"server_count": "The amount of servers bot is in.",
"shard_count": "The amount of shards a bot has."
}
404: Not Found
Could not find a bot with the ID specified.
{
"error": "true",
"message":"Bot Not Found"
}

Posting fake server or shard counts will result in a ban from our API.

post
Server/Shard Count Posting

https://bots.discordlabs.org/v2/bot/:botid/stats
Post your server/shard count to be displayed. (Should be sent every 30 minutes.)
Request
Response
Request
Path Parameters
Bot ID
required
number
ID of the bot you are checking the vote for.
Body Parameters
token
required
string
Your API Token. (Can be found on your manage bot page.)
server_count
required
string
Your current server count.
shard_count
optional
string
Your current shard count. (OPTIONAL)
Response
200: OK
Server/Shard count Successfully Posted
{
"error":"false"
}
400: Bad Request
Invalid API Token Provided
{
"error":"true",
"message":"Invalid API Token Provided"
}
429: Too Many Requests
You have been ratelimited.
{
"error":"true",
"message":"You have been ratelimited.",
"retry-after":"7" //Indicated how many minutes are left till you can try again.
}

All endpoints after this message have been deactivated until further notice.

get
Bot Votes

https://api.discordlabs.org/v1/bot/:id/votes
Get a list of all the users that have voted for your bot in the last 24 hours.
Request
Response
Request
Path Parameters
id
required
number
ID of the bot you want the votes for.
Response
200: OK
Votes list successfully retrieved.
{
"error": "false",
"votes": [
{"username":"User",
"discriminator":"1234",
"id":"01234567891234567"},
{"username":"User2",
"discriminator":"1234",
"id":"01234567891234568"},
{"username":"User5",
"discriminator":"12534",
"id":"01234567891235567"}
]
}
404: Not Found
Could not find a bot with the ID specified.
{
"error":"true",
"message":"Bot Not Found"
}

get
Individual User Voting Check

https://api.discordlabs.org/v1/bot/:botid/:userid/check
Check if a specific user has voted for you bot in the last 24 hours.
Request
Response
Request
Path Parameters
Bot ID
required
number
ID of the bot you are checking the vote for.
User Id
required
number
ID of the user you are checking the vote for.
Response
200: OK
Vote Check Successfully Retrieved
{
"error":"false",
"voted":"0" //Did Not Vote
}
or
{
"error":"false",
"voted":"1" //User Did Vote
}
404: Not Found
Could not find a bot with the ID specified.
{
"error":"true",
"message":"Bot Not Found"
}