Discord
Bots
Fetch a Discord bot
Get data from your favourite Discord bots
authorization<token>
In: header
Path Parameters
idstring
Response Body
curl -X GET "https://api.topstats.gg/discord/bots/string"
{
"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",
"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."
}
Fetch historical Discord bot data
Get historical data from Discord bots
authorization<token>
In: header
Path Parameters
idstring
Query Parameters
typestring
Value in
"monthly_votes" | "total_votes" | "server_count" | "review_count"
timeFramestring
Value in
"alltime" | "5y" | "3y" | "1y" | "270d" | "180d" | "90d" | "30d" | "7d" | "3d" | "1d" | "12h" | "6h"
Response Body
curl -X GET "https://api.topstats.gg/discord/bots/string/historical?type=monthly_votes&timeFrame=alltime"
{
"data": [
{
"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."
}
Fetch recent Discord bot data
Get recent discord data from the last 30 days and 30 hours
authorization<token>
In: header
Path Parameters
idstring
Response Body
curl -X GET "https://api.topstats.gg/discord/bots/string/recent"
{
"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."
}