API Introduction

Official documentation for the discordbotlist.com API.

Using discord.js or any other node.js library? Check out the official discordbotlist library!​
Our API is provided for users to get information on bots, submit their bot statistics and receive webhook requests when someone votes for their bot.
Reference
The base URL for our API is https://discordbotlist.com/api/v1 - v1 is currently the only version
Authentication
Authentication is required for POSTing bot statistics and maybe more endpoints in the future. This is done with an Authorization HTTP Header.
Example:
Header
Content
Authorization
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0IjoxLCJpZCI6IjM2NTk3NTY1NTYwODc0NTk4NSIsImlhdCI6MTU5MDI3NjEwOH0.UESu-Jm9kA_FCpRPSMjVwMGYJmLPxg44g_I7eDz5ZmQ
​

Implementing Voting

Last modified 2mo ago

Header	Content
Authorization	eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0IjoxLCJpZCI6IjM2NTk3NTY1NTYwODc0NTk4NSIsImlhdCI6MTU5MDI3NjEwOH0.UESu-Jm9kA_FCpRPSMjVwMGYJmLPxg44g_I7eDz5ZmQ