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