Bots

get
Bots
https://api.botlist.space/v1/bots
Retrieves all the bots listed on the site in a giant array.
Request
Response
Request
​
Response
200: OK
[
    { ... },
    { ... },
    { ... }
    ...
]
get
Bot by ID
https://api.botlist.space/v1/bots/:id
Gets a specific bot by an ID.
Request
Response
Request
Path Parameters
id
required
string
The ID of the bot you want to retrieve.
Response
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
Request
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.
Response
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
Request
Path Parameters
id
required
string
The ID of the bot you want to retrieve upvotes from.
Headers
Authorization
required
string
API bot token
Response
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
Request
Path Parameters
id
required
string
The ID of the bot you want to retrieve the uptime from.
Response
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
}
botlist.space - Previous
General
Next - botlist.space
Users
Last updated 7 months ago
Bots

getBots

getBot by ID

postServer Count

getBot Upvotes

getBot Uptime

get
Bots

get
Bot by ID

post
Server Count

get
Bot Upvotes

get
Bot Uptime
