Rankings

Fetch bot rankings

Get the top ranked bots across Discord!

Authorization

authorization<token>

In: header

Path Parameters

typeRequiredstring

Value in: "bots"

Query Parameters

limitnumber

Default: 100Maximum: 500

offsetnumber

Default: 0Minimum: 0

sortBystring

Default: "monthly_votes_rank"Value in: "monthly_votes_rank" | "total_votes_rank" | "server_count_rank"

sortMethodstring

Default: "asc"Value in: "desc" | "asc"

Response Body

Bot ranking data response

totalBotCountRequiredinteger

dataRequiredarray<object>

/**
 * Bot ranking data response
 */
export interface Response {
  totalBotCount: number;
  data: {
    id: string;
    name: string;
    monthly_votes: number;
    monthly_votes_rank: number;
    server_count: number;
    review_count: number;
    server_count_rank: number;
    total_votes: number;
    total_votes_rank: number;
    monthly_votes_rank_change: number;
    server_count_rank_change: number;
    total_votes_rank_change: number;
    review_count_change?: number;
  }[];
}

curl -X GET "https://api.topstats.gg/discord/rankings/bots?limit=100&offset=0&sortBy=monthly_votes_rank&sortMethod=desc" \
  -H "authorization: <token>"

{
  "totalBotCount": 43990,
  "data": [
    {
      "id": "432610292342587392",
      "name": "Mudae",
      "monthly_votes": 2312207,
      "monthly_votes_rank": 1,
      "server_count": 3371839,
      "server_count_rank": 13,
      "total_votes": 205265098,
      "review_count": 1050,
      "total_votes_rank": 1,
      "monthly_votes_rank_change": 1,
      "server_count_rank_change": 2,
      "total_votes_rank_change": 3
    },
    {
      "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,
      "review_count": 1050,
      "monthly_votes_rank_change": 0,
      "server_count_rank_change": 0,
      "total_votes_rank_change": 0
    }
  ]
}