Skip to content
TopStats

Rankings

Fetch rankings for the top bots

Terminal window
GET api.topstats.gg/discord/rankings/bots

Parameters

{
  "limit": "<number>" default: 100 | max: 500,
  "sortBy": "<string>" [
    'monthly_votes_rank',
    'total_votes_rank',
    'server_count_rank',
    'shard_count_rank'
  ],
  "sortMethod": "<string>" ['asc', 'desc'],
  "offset": "<number>"
}
{
  "totalBotCount": 43990,
  "data": [
    {
      "id": "432610292342587392",
      "name": "Mudae",
      "monthly_votes": 2312207,
      "monthly_votes_rank": 1,
      "server_count": 3371839,
      "server_count_rank": 13,
      "total_votes": 205265098,
      "total_votes_rank": 1,
      "shard_count": 1792,
      "shard_count_rank": 4,
      "monthly_votes_rank_change": 1,
      "server_count_rank_change": 2,
      "total_votes_rank_change": 3,
      "shard_count_rank_change": -10
    },
    {
      "id": "646937666251915264",
      "name": "Karuta",
      "monthly_votes": 1350833,
      "monthly_votes_rank": 2,
      "server_count": 841460,
      "server_count_rank": 38,
      "total_votes": 97917149,
      "total_votes_rank": 2,
      "shard_count": 416,
      "shard_count_rank": 31,
      "monthly_votes_rank_change": 0,
      "server_count_rank_change": 0,
      "total_votes_rank_change": 0,
      "shard_count_rank_change": 0
    },
    {
      "id": "716390085896962058",
      "name": "Pokétwo",
      "monthly_votes": 390317,
      "monthly_votes_rank": 3,
      "server_count": 1477470,
      "server_count_rank": 25,
      "total_votes": 73038392,
      "total_votes_rank": 4,
      "shard_count": 945,
      "shard_count_rank": 15,
      "monthly_votes_rank_change": 0,
      "server_count_rank_change": 0,
      "total_votes_rank_change": 0,
      "shard_count_rank_change": 0
    },
    {
      "id": "664508672713424926",
      "name": "PokéMeow",
      "monthly_votes": 222245,
      "monthly_votes_rank": 6,
      "server_count": 498432,
      "server_count_rank": 62,
      "total_votes": 37016205,
      "total_votes_rank": 6,
      "shard_count": 0,
      "shard_count_rank": 19196,
      "monthly_votes_rank_change": 0,
      "server_count_rank_change": 0,
      "total_votes_rank_change": 0,
      "shard_count_rank_change": -14
    },
    ... more entries
  ]
}