Endpoints

The HTTP endpoints for our API.

Ratelimits

Default Ratelimits (GET Requests)

You are limited by IP instead of by bot.

Standard Bots (Approved, not Verified)

All non verified bots have an API ratelimit of 5 requests per 10 seconds.

Verified Bots

All verified bots have an API ratelimit of 20 requests per 10 seconds.

get
Bot Information

https://discordextremelist.xyz/api/bot/:id
Get JSON encoded information about a bot.
Request
Response
Request
Path Parameters
id
required
string
The bot's Discord ID.
Response
200: OK
You will be returned JSON encoded information about a bot.
{
"error": false,
"status": 200,
"bot": {
"avatar": {
"hash": "514ace79af511823e12f75f8b8a4c939",
"url": "https://cdn.discordapp.com/avatars/568254611354419211/514ace79af511823e12f75f8b8a4c939"
},
"id": "568254611354419211",
"inviteCount": 0,
"library": "discord.js",
"links": {
"donation": "https://example.com/givememoney",
"invite": "https://example.com/discordinvite?ref=interestingtrackerthingieidk", // Is blank if permissionless
"repo": "https://github.com/suchuser/suchrepo",
"support": "https://discord.gg/suchsupportlovely",
"website": "https://example.com"
},
"longDesc": "amazing",
"name": "Discord Extreme List",
"owner": {
"id": "208105877838888960"
},
"prefix": "$",
"serverCount": 0,
"shortDesc": "such a good bot",
"status": {
"approved": false,
"pendingVerification": false,
"verified": false
}
}
}
404: Not Found
The bot ID you inputted was not found in DEL's database. (The bot isn't listed on DEL).
{
"error": true,
"message": 'Bot not found.',
"status": 404
}

get
User Information

https://discordextremelist.xyz/api/user/:id
Get JSON encoded information about a user.
Request
Response
Request
Path Parameters
id
required
string
The user's Discord ID.
Response
200: OK
You will be returned JSON encoded information about a user.
{
"error": false,
"status": 200,
"user": {
"avatar": {
"hash": "7231f68b03693fd0554b4c984e2c02c3",
"url": "https://cdn.discordapp.com/avatars/208105877838888960/7231f68b03693fd0554b4c984e2c02c3"
},
"discrim": "0001",
"fullUsername": "Cairo#0001",
"game": {
"snakes": {
"maxScore": 0
}
},
"id": "208105877838888960",
"name": "Cairo",
"profile": {
"bio": "",
"css": "",
"links": {
"github": "Username",
"gitlab": "Username",
"instagram": "Username",
"snapchat": "Username",
"twitter": "@Username",
"website": "https://example.com"
}
},
"rank": {
"admin": false,
"mod": false,
"verified": false
}
}
}
404: Not Found
The user ID you inputted was not found on DEL's database. (The user hasn't logged on to DEL before).
{
"error": true,
"message": 'User not found.',
"status": 404
}

get
Bot Widget

https://discordextremelist.xyz/api/bot/:id/widget
Get a bot widget in the PNG format.
Request
Response
Request
Path Parameters
id
required
string
The bot's Discord ID.
Query Parameters
type
optional
string
Append ?type=svg to the url for an svg version of the bot widget, widget defaults to png.
Response
200: OK
You will receive your bot's widget in the PNG format.
‚Äč
404: Not Found
The bot ID you inputted was not found in DEL's database. (The bot isn't listed on DEL).
{
"error": true,
"message": 'Bot does not exist.',
"status": 404
}

post
Bot Guild Count

https://discordextremelist.xyz/api/bot/:id
Update your bot's guild count (to show how many servers your bot is in on it's profile). NOTICE: Inputting false numbers is against DEL's Guidelines and will result in termination of your bot's listing and termination of access of most of the features on DEL.
Request
Response
Request
Path Parameters
id
required
string
The ID of the bot that you are updating the guild count of.
Headers
authorization
required
string
Your bot token is accompained with this, if you do not supply the authorization token your request will fail.
Body Parameters
guildCount
required
number
Your bot's server/guild count goes here.
Response
200: OK
The server count was successfully updated with the number you supplied.
{
"error": true,
"message": 'Server count successfully updated.',
"status": 200
}
400: Bad Request
A new value for the servers (that is meant to be included in the body of the request) was not included. or An invalid number was inputted (words instead of numerals: one two three, 123).
{
"error": true,
"message": 'Server count is required.',
"status": 400
}
// or
{
"error": true,
"message": 'Server count must be a valid number.',
"status": 400
}
401: Unauthorized
An authorization header was not supplied.
{
"error": true,
"message": 'Authorization is required.',
"status": 401
}
403: Forbidden
The authorization token did not match the generated token for the bot.
{
"error": true,
"message": 'Invalid authorization token.',
"status": 403
}
404: Not Found
The bot ID you inputted was not found in DEL's database. (The bot isn't listed on DEL).
{
"error": true,
"message": 'Bot not found.',
"status": 404
}