API Overview

The discord.place REST API lets bot developers post stats and receive vote events.

The discord.place API allows bot developers to keep their bot listings up to date, check voter status, and receive real-time vote notifications via webhooks.

Base URL

https://api.discord.place

API Version: 1.1.0
Content-Type: All requests and responses use application/json.

Response Format

Every response includes a success boolean at the top level. Error responses additionally include an error string describing the problem and a status integer matching the HTTP status code.

// Success
{ "success": true }

// Error
{
  "success": false,
  "error": "Bot not found.",
  "status": 404
}

Available Endpoints

Update Bot Stats

PATCH /bots/{id}/stats
Update your bot’s server count and command count.

Check Vote Status

GET /bots/{id}/voters/{user_id}
Check whether a user has voted for your bot in the last 24 hours.

Webhooks

When a user votes for your bot or server, discord.place sends an HTTP POST request to your configured webhook URL. This lets you reward voters in real time without polling.

See the Vote Webhooks page for the full payload reference and a ready-to-use handler example.

Quick Example

Update your bot’s server count with a single curl command:

curl -X PATCH https://api.discord.place/bots/123456789012345678/stats \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"server_count": 1500}'

A successful response:

{ "success": true }

Next Steps

Authentication

Learn how to generate and use your API key.

Rate Limits

Understand the rate limits that apply to all endpoints.