Botlist.me API

The api can be both accessed from https://botlist.me/api and https://api.botlist.me

get
Bot Embed

https://botlist.me/api/v1/embed/:id
Generates you an embed to put on your bots website/Github
Request
Response
Request
Path Parameters
id
required
integer
Bot id
Response
200: OK
Returns a png image
"Content-Type": "image/png"

post
Update Bot Stats

https://botlist.me/api/v1/bots/:id/stats
Update your bots server count and shard count displayed on the website
Request
Response
Request
Path Parameters
id
required
integer
Bot id
Headers
authorization
required
string
Bot Auth token that can be found by editing your bot
Body Parameters
shard_count
optional
integer
Shard count of your bot
server_count
required
integer
Server count of your bot
Response
200: OK
Indicates that there was no errors with your request and stat update has succeeded
{
error: false
}

get
Has Voted

https://botlist.me/api/v1/bots/:id/hasvoted
Check if a user has voted for your bot in the last 12 hours
Request
Response
Request
Path Parameters
id
required
integer
Bot id
Headers
authorization
required
string
Bot Auth token that can be found by editing your bot
Body Parameters
userid
required
integer
User id of the user to check
Response
200: OK
Indicates that the user has voted for your bot in the last 12 hours
{
"hasVoted": true
}

‚Äč