Bots | TopStats

Fetch a Bot

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

Query Parameters

{
    "id": "<string>"
}

Response

Response
Body

{
    "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,
    "percentage_changes": {
        "daily": 0,
        "monthly": 200
    }
}

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
`percentage_changes.daily`	Percentage change of the last day	number
`percentage_changes.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
Body

{
    "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
    ]
}

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
Body

{
    "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
    ]
}

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