Bots

Fetch a Bot

GET api.topstats.gg/discord/bots/:id

Query Parameters

{
    "id": "<string>"
}

Response

Response

{
    "certified": false,
    "owners": [
        "321714991050784770",
        "205680187394752512",
        "116930717241311236"
    ],
    "deleted": false,
    "id": "583807014896140293",
    "name": "DBL Statistics",
    "def_avatar": "1cbd08c76f8af6dddce02c5138971129",
    "avatar": "d9c16daef96dfa39e4b1235e5bcd9979",
    "short_desc": "Get statistics of every bot listed on top.gg",
    "lib": "discord.js",
    "prefix": "dbl-",
    "website": "https://dblstatistics.com/",
    "approved_at": "2020-08-02T12:39:32.440Z",
    "monthly_votes": 32,
    "server_count": 68,
    "total_votes": 33,
    "shard_count": 0,
    "monthly_votes_rank": 1023,
    "server_count_rank": 3176,
    "total_votes_rank": 4708,
    "shard_count_rank": 11974,
    "timestamp": "2020-08-15T08:00:00.222Z",
    "unix_timestamp": 1597478400,
    "percentageChanges": {
        "daily": 0,
        "monthly": 200
    }
}

Body

Value	Description	Type
certified Deprecated	Is the Bot Certified On Top.gg?	boolean
owners	Array of Discord ID’s	array null
deleted	Is the Bot deleted from Top.gg?	boolean
id	Discord ID of the bot	string
name	Discord name of the bot	string
def_avatar	Default discord avatar for the bot	string
avatar	Discord avatar of the bot	string null
short_desc	Bot Short Description from Top.gg	string
lib Deprecated	Library in which the bot is written in	string
prefix	Bot’s prefix	string
approved_at	Date when the bot was approved on Top.gg	string
monthly_votes	Current monthly votes count	number
server_count	Current server count	number
total_votes	Current count for all votes	number
shard_count	Current shard count	number
monthly_votes_rank	Current monthly votes rank	number
server_count_rank	Current server count rank	number
total_votes_rank	Total votes rank	number
shard_count_rank	Shard count rank	number
timestamp	Last modified timestamp	string
unix_timestamp	Last modified unix timestamp	number
percentageChanges.daily	Percentage change of the last day	number
percentageChanges.monthly	Percentage change of the last monthly	number

Fetch a Bot’s Historical Data

GET api.topstats.gg/discord/bots/:id/historical

Query

{
    "id": "<string>"
}

Parameters

{
    "timeFrame": "<string>" ['alltime','5y','3y','1y','270d','180d','90d','30d','7d','3d','1d','12h','6h']
    "type": "<string>" ['monthly_votes','total_votes','server_count','shard_count']
}

Response

{
    "data": [
        {
            "time": "2024-10-01T00:00:00.000Z",
            "id": "583807014896140293",
            "monthly_votes": 1
        },
        {
            "time": "2024-09-01T00:00:00.000Z",
            "id": "583807014896140293",
            "monthly_votes": 2
        },
        {
            "time": "2024-08-01T00:00:00.000Z",
            "id": "583807014896140293",
            "monthly_votes": 1
        },
        ... more entries
    ]
}

Body

Value	Description	Type
time	Date of value	string
id	Discord ID of the bot	string
value	Value of the requested type	number

Fetch a Bot’s Recent Data

GET api.topstats.gg/discord/bots/:id/recent

Query

{
    "id": "<string>"
}

Response

{
    "hourlyData": [
        {
            "time": "2024-10-18T18:00:00.000Z",
            "monthly_votes": 1800088,
            "server_count": 3371839,
            "shard_count": 1792,
            "total_votes": 204896149,
            "monthly_votes_change": 7310,
            "monthly_votes_change_perc": 0.41,
            "server_count_change": 0,
            "shard_count_change": 0,
            "total_votes_change": 5028
        },
        {
            "time": "2024-10-18T17:00:00.000Z",
            "monthly_votes": 1792778,
            "server_count": 3371839,
            "shard_count": 1792,
            "total_votes": 204891121,
            "monthly_votes_change": 7232,
            "monthly_votes_change_perc": 0.41,
            "server_count_change": 0,
            "shard_count_change": 0,
            "total_votes_change": 4884
        },
        ... 28 more entries
    ],
    "dailyData": [
        {
            "time": "2024-10-18T00:00:00.000Z",
            "monthly_votes": 1800088,
            "server_count": 3371839,
            "shard_count": 1792,
            "total_votes": 204896149,
            "monthly_votes_change": 110263,
            "monthly_votes_change_perc": 6.53,
            "server_count_change": 0,
            "shard_count_change": 0,
            "total_votes_change": 79940
        },
        {
            "time": "2024-10-17T00:00:00.000Z",
            "monthly_votes": 1689825,
            "server_count": 3371839,
            "shard_count": 1792,
            "total_votes": 204816209,
            "monthly_votes_change": 73997,
            "monthly_votes_change_perc": 4.58,
            "server_count_change": 0,
            "shard_count_change": 0,
            "total_votes_change": 53552
        },
        ... 28 more entries
    ]
}

Body

Value	Description	Type
time	Date of value	string
monthly_votes	Monthly votes count	string
server_count	Server count	number
shard_count	Shard count	string
total_votes	Total vote count	string
monthly_votes_change	Monthly votes difference	number
monthly_votes_change_perc	Monthly votes change percentage	string
server_count_change	Server count difference	string
shard_count_change	Shard count change	number