Bots

{
  "id": "583807014896140293",
  "topGGId": "583807014896140293",
  "certified": false,
  "owners": [
    "321714991050784770",
    "205680187394752512",
    "116930717241311236"
  ],
  "deleted": false,
  "name": "TopStats",
  "def_avatar": "1.png",
  "avatar": "https://cdn.discordapp.com/avatars/583807014896140293/991f10cb648e9115e5f6522a40f34d55.png",
  "short_desc": "Get statistics of every bot listed on top.gg, check out the latest rankings and data on TopStats.gg\n\n",
  "lib": "",
  "prefix": "/",
  "website": "https://topstats.gg",
  "approved_at": "2020-08-02T12:38:42.000Z",
  "monthly_votes": 4,
  "server_count": 364,
  "total_votes": 278,
  "review_count": 0,
  "monthly_votes_rank": 1649,
  "server_count_rank": 3420,
  "total_votes_rank": 4491,
  "timestamp": "2025-04-30T13:00:00Z",
  "unix_timestamp": "1746018000000",
  "unlisted": false,
  "unlisted_reason": "This bot was taken down for breaking our Terms of Service",
  "tags": [
    "bot-statistics",
    "infomation-statistics",
    "rankings",
    "ranks",
    "social",
    "statistics",
    "stats",
    "topgg",
    "web-dashboard"
  ],
  "avg_review_rating": 4.9,
  "percentage_changes": {
    "daily": 0,
    "monthly": 0.34
  }
}

{
  "code": 404,
  "message": "Not found, no bot exists with the id provided."
}

{
  "data": [
    {
      "compare": null,
      "time": "2025-03-31T00:00:00.000Z",
      "id": "583807014896140293",
      "monthly_votes": 265,
      "total_votes": 265,
      "server_count": 265,
      "review_count": 265
    }
  ]
}

{
  "code": 404,
  "message": "Not found, no bot exists with the id provided."
}

{
  "hourlyData": [
    {
      "time": "2024-10-18T18:00:00.000Z",
      "monthly_votes": 1800088,
      "server_count": 3371839,
      "total_votes": 204896149,
      "monthly_votes_change": 7310,
      "monthly_votes_change_perc": 0.41,
      "server_count_change": 0,
      "total_votes_change": 5028
    }
  ],
  "dailyData": [
    {
      "time": "2024-10-18T00:00:00.000Z",
      "monthly_votes": 1800088,
      "server_count": 3371839,
      "total_votes": 204896149,
      "monthly_votes_change": 110263,
      "monthly_votes_change_perc": 6.53,
      "server_count_change": 0,
      "total_votes_change": 79940
    }
  ]
}

{
  "code": 404,
  "message": "Not found, no bot exists with the id provided."
}

{
  "code": 200,
  "data": {
    "total": 11,
    "leaderboard": [
      {
        "position": "1",
        "connectionId": "809106054496370688",
        "userId": "3323278129891049472",
        "voteCount": 2,
        "totalVotesByWeight": 2,
        "lastVote": "2026-02-11T06:50:00.245Z",
        "user": {
          "topggId": "3323278129891049472",
          "discordId": "205680187394752512",
          "username": "xignotic",
          "avatar": "https://cdn.discordapp.com/avatars/205680187394752512/9d9214191caa8969d907c91444261755.png"
        }
      }
    ]
  }
}

{
  "code": 404,
  "message": "Not found, no bot exists with the id provided."
}

{
  "code": 200,
  "total": "12",
  "data": {
    "position": "3",
    "connectionId": "809106054496370688",
    "userId": "7709988444184444928",
    "voteCount": 2,
    "totalVotesByWeight": 2,
    "lastVote": "2026-02-11T10:35:12.383Z",
    "user": {
      "topggId": "7709988444184444928",
      "discordId": "116930717241311236",
      "username": "luke.stoodley",
      "avatar": "https://cdn.discordapp.com/avatars/116930717241311236/7493d96193c36affe3a721ac61df9cec.png"
    }
  }
}

{
  "code": 404,
  "message": "Not found, no bot exists with the id provided."
}