Compare

Compare Discord bots

Authorization

authorization<token>

In: header

Path Parameters

*Requiredstring

Response Body

Default Response

dataarray<object>

export interface Response {
  data?: {
    id: string;
    topGGId: string;
    certified?: boolean;
    owners: string[];
    deleted: boolean;
    name: string;
    def_avatar: string;
    avatar?: string;
    short_desc: string;
    lib?: string;
    prefix: string;
    website?: string;
    approved_at: string;
    monthly_votes: number;
    server_count?: number;
    total_votes: number;
    review_count: number;
    monthly_votes_rank: number;
    server_count_rank: number;
    total_votes_rank: number;
    timestamp: string;
    unix_timestamp?: string;
    tags: string[];
    avg_review_rating: number;
    percentage_changes: {
      daily?: number;
      monthly?: number;
    };
  }[];
}

curl -X GET "https://api.topstats.gg/discord/compare/string" \
  -H "authorization: <token>"

{
  "data": [
    {
      "id": "432610292342587392",
      "topGGId": "432610292342587392",
      "certified": false,
      "owners": [
        "275748765166469120"
      ],
      "deleted": false,
      "name": "Mudae",
      "def_avatar": "1.png",
      "avatar": "https://cdn.discordapp.com/avatars/432610292342587392/29cb28fbf65a3958105026ab03abd306.png",
      "short_desc": "Database of 110,000 anime/game characters: make and customize the best collection in your server. 400 commands, multiplayer games and more!",
      "lib": "",
      "prefix": "$",
      "website": "https://www.patreon.com/mudae",
      "approved_at": "2018-04-21T21:17:57.793Z",
      "monthly_votes": 22409,
      "server_count": 3371839,
      "total_votes": 221179584,
      "shard_count": 0,
      "monthly_votes_rank": 1,
      "server_count_rank": 15,
      "shard_count_rank": 12288,
      "total_votes_rank": 1,
      "timestamp": "2025-05-01T07:00:00Z",
      "unix_timestamp": "1746082800000",
      "tags": [
        "anime",
        "fun",
        "game"
      ],
      "avg_review_rating": 4.526118704362479,
      "review_count": 10682,
      "percentage_changes": {
        "daily": 11.12,
        "monthly": 0.97
      }
    },
    {
      "id": "646937666251915264",
      "topGGId": "646937666251915264",
      "certified": false,
      "owners": [
        "141431182792458241",
        "135694375647838208"
      ],
      "deleted": false,
      "name": "Karuta",
      "def_avatar": "1.png",
      "avatar": "https://cdn.discordapp.com/avatars/646937666251915264/0e54d87446f106d1fd58385295ae9deb.png",
      "short_desc": "#1 ANIME CARD BOT! 🎴 Over 160,000 anime cards to collect, trade, customize, date, fight, and more in a global economy.",
      "lib": "",
      "prefix": "k!",
      "website": "https://karuta.com/",
      "approved_at": "2020-02-06T10:09:04.845Z",
      "monthly_votes": 11297,
      "server_count": 853288,
      "total_votes": 106916622,
      "shard_count": 0,
      "monthly_votes_rank": 2,
      "server_count_rank": 42,
      "shard_count_rank": 17451,
      "total_votes_rank": 2,
      "timestamp": "2025-05-01T07:00:00Z",
      "unix_timestamp": "1746082800000",
      "tags": [
        "anime",
        "art",
        "economy",
        "fun",
        "game",
        "gaming",
        "genshin",
        "leveling",
        "pokemon",
        "roleplay",
        "social",
        "utility"
      ],
      "avg_review_rating": 4.053977272727272,
      "review_count": 1056,
      "percentage_changes": {
        "daily": 12.57,
        "monthly": 0.98
      }
    }
  ]
}

Compare Discord bots historical data

Authorization

authorization<token>

In: header

Path Parameters

*Requiredstring

Query Parameters

typeRequiredstring

Value in: "monthly_votes" | "total_votes" | "server_count" | "review_count"

timeFrameRequiredstring

Value in: "alltime" | "5y" | "3y" | "1y" | "270d" | "180d" | "90d" | "30d" | "7d" | "3d" | "1d" | "12h" | "6h"

Response Body

Default Response

dataRequiredobject

export interface Response {
  data: {
    [k: string]: {
      time: string;
      id: string;
      monthly_votes?: number;
      total_votes?: number;
      server_count?: number;
      review_count?: number;
    }[];
  };
}

curl -X GET "https://api.topstats.gg/discord/compare/historical/string?type=monthly_votes&timeFrame=alltime" \
  -H "authorization: <token>"

{
  "data": {
    "432610292342587392": [
      {
        "time": "2024-11-23T19:00:00.000Z",
        "id": "432610292342587392",
        "monthly_votes": 2432848
      },
      {
        "time": "2024-10-31T00:00:00.000Z",
        "id": "432610292342587392",
        "monthly_votes": 3157605
      },
      {
        "time": "2024-09-30T00:00:00.000Z",
        "id": "432610292342587392",
        "monthly_votes": 3242100
      },
      {
        "time": "2024-08-31T00:00:00.000Z",
        "id": "432610292342587392",
        "monthly_votes": 3429877
      },
      {
        "time": "2024-07-31T00:00:00.000Z",
        "id": "432610292342587392",
        "monthly_votes": 3163827
      }
    ],
    "646937666251915264": [
      {
        "time": "2024-11-23T19:00:00.000Z",
        "id": "646937666251915264",
        "monthly_votes": 1407882
      },
      {
        "time": "2024-10-31T00:00:00.000Z",
        "id": "646937666251915264",
        "monthly_votes": 1848793
      },
      {
        "time": "2024-09-30T00:00:00.000Z",
        "id": "646937666251915264",
        "monthly_votes": 1822779
      },
      {
        "time": "2024-08-31T00:00:00.000Z",
        "id": "646937666251915264",
        "monthly_votes": 1845849
      },
      {
        "time": "2024-07-31T00:00:00.000Z",
        "id": "646937666251915264",
        "monthly_votes": 1640492
      }
    ]
  }
}