Bots on Discord Bot API

Getting Started

To use the bot API you first need an API key. To get one go to the API Keys page under your username on the navbar. This key goes in the Authorization header of all API requests.

Bots should send all API requests to https://bots.ondiscord.xyz/bot-api/ with authentication. Ratelimits are used in all routes and appear in response headers.

If a request fails it will have a message field in the response body explaining the problem.

Guild Count

Update a bot's guild count. Trying to update the guild count for a bot that is not approved will return a 404 Not Found error.

Endpoint: POST /bots/:id/guilds
Ratelimit: 1req / 2min / bot

Sample request:

POST https://bots.ondiscord.xyz/bot-api/bots/125367104336691200/guilds HTTP/1.1
Authorization: b1c678e8b0a346efe45e97c12b28f074
Content-Type: application/json

{
	"guildCount": 54783
}

Returns: 204 No Content

Check Review

Check if a user has reviewed a bot. Returns a JSON response with the field exists, indicating if a review exists.

Endpoint: GET /bots/:id/review?owner={user id}
Ratelimit: 20req / 10s / bot

Sample request:

GET https://bots.ondiscord.xyz/bot-api/bots/125367104336691200/review?owner=437086154215391233 HTTP/1.1
Authorization: b1c678e8b0a346efe45e97c12b28f074

Returns:

{
	"exists": true
}

Tip: You can click on tags to see a bot's description for that tag.