Botlist.me API

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

get
Bot Embed

https://api.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://api.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://api.botlist.me/api/v1/bots/:id/voted
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
Query Parameters
userId
required
integer
User id of the user to check
Response
200: OK
hasVoted: boolean, indicates if a user has voted in the last 12 hours. timestamp: timestamp, The timestamp at which the user has voted.
{
"hasVoted": true,
"timestamp": "2021-07-09T13:31:44.876+00:00"
}

get
Has Voted -LEGACY

https://api.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
hasVoted: boolean, indicates if a user has voted in the last 12 hours. timestamp: timestamp, The timestamp at which the user has voted.
{
"hasVoted": true,
"timestamp": "2021-07-09T13:31:44.876+00:00"