Endpoints

Bot Endpoints

post
Server Count

https://glennbotlist.xyz/api/bot/:id/stats
This endpoint post your server count to the website
Request
Response
Request
Path Parameters
id
required
integer
ID of the bots stats you are posting
Headers
authorization
required
string
Bot's auth key
Body Parameters
serverCount
required
integer
Amount of servers your bot is in
shardCount
optional
integer
Amount of shards your bot has made
Response
200: OK
Server Count Posted Successfully.
{ "msg": "Sucessful request.", "code": 200 }
400: Bad Request
Reasons for this response: - No body in the request - serverCount and/or authorization wasn't passed - serverCount, serverShard, authorization was passed incorrectly
{ "msg": "Bad Request.", "code": 400 }
401: Unauthorized
Token is invalid / doesn't matches bot's key
{ "msg": "Unauthorized.", "code": 401 }
404: Not Found
Bot ID was not found
{ "msg": "Not Found.", "code": 404 }

get
Bot Stats

https://glennbotlist.xyz/api/bot/:id/
Retrieves stats about a bot
Request
Response
Request
Body Parameters
id
required
integer
id of the bot you are attempting to get stats for
Response
200: OK
Bot info received successfully
{'msg': 'Sucessfull request.', 'code': 200,
'name': 'Bot', 'id': '000000000000000000', 'main_owner': '000000000000000000',
'owners': [], 'library': 'discord.py',
'monthly_upvotes': 0, 'total_upvotes': 0,
'website': 'https://bot.com', 'github': '',
'short_description': "Short Description", 'prefix': '!',
'certified': False, 'partnered': False, 'vanity_url': '',
'featured': False, 'invite_url': 'https://discordapp.com/oauth2/authorize?client_id=000000000000000000&permissions=0&scope=bot',
'support_server': 'https://discord.gg/botcode',
'server_count': 15, 'shard_count': 0,
'tags': ['Music', 'Moderation', 'Logging', 'Leveling'],
'rates': [], 'widget': 'https://glennbotlist.xyz/bot/000000000000000000/widget'}
404: Not Found
Bot was not found
{ "msg": "Not Found.", "code": 404 }

Bot Stats Attributes

  • name: Bot name

  • id: Bot client ID

  • main_owner: Bot owner id

  • owners: Other bot owners (array w/IDs)

  • library: The bot code library (discord.js, discord.py, etc.)

  • monthly_upvotes: Upvote count (in the current month)

  • total_upvotes: Total upvotes (all time)

  • website: Bot website or ""

  • github: Bot Github link or ""

  • short_description: Bot short description

  • prefix: Bot prefix

  • certified: Bot is certified? true/false

  • partnered: Bot is partnered? true/false

  • vanity_url: Bot vanity URL

  • featured: Bot is featured? true/false

  • invite_url: Bot invite URL

  • support_server: Bot support server URL

  • server_count: Bot server count

  • shard_count: Bot shard count

  • tags: Website tags (array)

  • rates: All bot ratings: [{"rate":1-5,"id":"rate_user_id"}]

  • widget: The bots widget

get

https://glennbotlist.xyz/api/bot/:id/votes
Get the bot's all time count, monthly count (as well as users voted for the month), and users voted in the past 12 hours
Request
Response
Request
Path Parameters
id
required
integer
Bot's id
Headers
authorization
optional
string
Bot's auth key
Response
200: OK
Bot's votes received
{'msg': 'Sucessful request.', 'code': 200,
'current_votes': {'alltime': 0, 'monthly': 0}}
401: Unauthorized
Token is invalid / doesn't match bot's key
{ "msg": "Unauthorized.", "code": 401 }
404: Not Found
Bot not found
{ "msg": "Not Found.", "code": 404 }

get
User Info

https://glennbotlist.xyz/api/user/:id
Gets a user's info
Request
Response
Request
Path Parameters
id
optional
integer
User's id
Response
200: OK
{'msg': 'Sucessfull request.', 'code': 200,
'id': '0000000000000000', 'username': 'User',
'discriminator': '0000',
'avatar': 'https://cdn.discordapp.com/avatars/0000000000000000/c9d6eb23f2b2af5d7e2bbb40c753fb33',
'background': None, 'bio': 'I am a mysterious person.',
'certified_developer': False, 'custom_background': None,
'mod': False, 'admin': False, 'karma': 19, 'total_karma': 19}
404: Not Found
User not found
{ "msg": "Not Found.", "code": 404 }

get
Widget

https://glennbotlist.xyz/bot/:id/widget
Gets a bot's widget (Although not technically an API endpoint, it still technically is)
Request
Response
Request
Path Parameters
id
optional
integer
Bot's id
Response
200: OK
Returns an image object
Image Object
404: Not Found
Bot not found
{"msg": "Couldn't find that bot."}