API Endpoints

Update Servercount

PATCH https://api.discord-botlist.eu/v1/update

This endpoint allows you to get free cakes.

Headers

Name	Type	Description
Authorization*	string	Authentication token to identify your bot. We use Bearer as method

Request Body

Name	Type	Description
serverCount*	number	Your new servercount. MUST BE SEND AS JSON

200 Patch successful

{"updated": [ "SERVER_COUNT" ]}

403 Could not authorize you

{"message":"'authorization' header is missing"}

500: Internal Server Error

{
    message: "Servercount must be a number! Got undefined"
    //This usually means that your body is wrongly encoded. Try adding "Content-Type: application/json" to your request header and make sure you are not sending the data as a string
}

Get all Votes

GET https://api.discord-botlist.eu/v1/votes

Headers

Name	Type	Description
Authorization	string	Authentication token to identify your bot. We use Bearer as method

200

[
    "2021-06-12T12:00:29.893Z",
    "..."
]

403

{"message":"'authorization' header is missing"}

Get all botdata

GET https://api.discord-botlist.eu/v1/ping

Headers

Name	Type	Description
Authorization	string	Authentication token to identify your bot. We use Bearer as method

200

{
    "discord": {
        "id": "1234324234234234,
        "username": "TestBot",
        "discriminator": "2998",
        "tag": "TestBot#2998"
    },
    "botlist": {
        "serverCount": null,
        "developer": {
            "main": "843567384657832342",
            "additional": [
                ""
            ]
        },
        "upvotes": [
            "2021-06-12T12:00:29.893Z",
            "2021-07-11T13:25:33.807Z",
            "2021-07-12T02:32:53.840Z",
            "2021-07-12T02:35:39.727Z",
            "2021-08-01T15:44:23.285Z"
        ],
        "flags": [
            "CERTIFIED",
            "BANNER_GIF"
        ],
        "banner": "https://example.com",
        "website": "https://example.com",
        "prefix": "!",
        "longdesc": "Longdesc",
        "shortdesc": "Shortdesc",
        "invite": "https://example.com",
        "vanity": "test_bot",
        "theme": "#0073ff"
    }
}

403

{"message":"'authorization' header is missing"}