# API Introduction

{% hint style="info" %}
Using discord.js or any other node.js library? [Check out the official discordbotlist library!](https://www.npmjs.com/package/discordbotlist)
{% endhint %}

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 |