Vote API

If you are unable to implement the recommended method of voting, Webhooks, an endpoint is provided which returns the most recent 500 votes, alongside a timestamp.

GET Votes

GET https://discordbotlist.com/api/v1/bots/:id/upvotes

Returns the most recent 500 votes alongside the total number of votes in the past 12 hours.

Path Parameters

Name	Type	Description
:id*	String	Bot ID

Headers

Name	Type	Description
Authorization	String	discordbotlist.com token

200: OK

{
  "upvotes": [
    {
      "user_id": "149505704569339904",
      "timestamp": "2023-01-09T02:26:33.375Z", // Use this to find new votes
      "username": "luke",
      "discriminator": "0123",
      "avatar": "11a25559098e81115f7b395c511e6633"
    }
  ],
  "total": 1 // Total upvotes over 12 hours. The "upvotes" array only returns the recent 500.
}