Endpoints

BASE URL api.discord.place

Update Bot Stats

PATCH /bots/:bot_id/stats

Using this endpoint, you can update the command value that appear on the bot page. We recommend you to do this every 24 hours and keep the page updated with this endpoint.

Headers

Name	Value
Content-Type	application/json
Authorization	YOUR_API_KEY

Body

Name	Type	Description
command_count	integer	Bot's commands size
server_count	integer	Bot's guilds count

Just a heads-up

Even though you set the server count, this value can only be at most 50 more or less than the actual server count of your bot.

Response

200 OK

{
  "success": true
}

400 Bad Request

{
  "success": false,
  "error": "<validation_error>",
  "status": 400
}

401 Unauthorized

{
  "success": false,
  "error": "Invalid API key.",
  "status": 401
}

{
  "success": false,
  "error": "Authorization header is required.",
  "status": 401
}

404 Not Found

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

Fetch Vote Status

GET /bots/:bot_id/voters/:user_id

Check if user has voted for your bot in the last 24 hours.

Headers

Name	Value
Content-Type	application/json
Authorization	YOUR_API_KEY

Response

200 OK

{
  "voted": false,
  "vote": 0,
  "lastVote": null
}

{
  "voted": true,
  "vote": 1,
  "lastVote": 1726566555943 // Tue Sep 17 2024 12:49:15 GMT+0300 (GMT+03:00)
}

401 Unauthorized

{
  "success": false,
  "error": "Invalid API key.",
  "status": 401
}

{
  "success": false,
  "error": "Authorization header is required.",
  "status": 401
}

403 Forbidden

{
  "success": false,
  "error": "User did not vote in the last 24 hours.",
  "status": 403
}

404 Not Found

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