API Docs

All these endpoints are ratelimited to twice every 10 minutes. Exceeding this will result in a 429 ratelimit error. Exceeding the limit of more than twice a minute will result in a 60 minute block. Repeatedly getting blocked will result in a ban from our API endpoint.

get
Bot Info

https://api.discordlabs.org/v1/bot/:id
This endpoint allows you to get info on a bot listed on BotCord.
Request
Response
Path Parameters
id
required
number
ID of the bot you are searching for.
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://api.discordlabs.org/v1/bot/:botid/stats
Post your server/shard count to be displayed. (Should be sent every 30 minutes.)
Request
Response
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 profile page.)
server_count
required
string
Your current server count.
shard_count
optional
string
Your current shard count. (OPTIONAL)
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.
}

If you post your shard count, only your shard count will be shown. If you would like your server count to be shown instead, don't post your shard count. Only post your shard count if you have more than 1 shard. If you want your shard count to show you must post your shard and server count.

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
Path Parameters
id
required
number
ID of the bot you want the votes for.
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
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.
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"
}