API Documentation
Here you will find all the useable endpoints on DBL Statistics.
All requests to the API require you to provide an API key which you can find on your
User Page
Please provide this is the headers under the
Authorization key, for example:
{
"Authorization": "My Super Secret Key"
}
Endpoint: /api/bots/:id
Ratelimit: 60 requests per minute
Example Output:
{
"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
}
Endpoint: /api/bots/:id/previous
Query Options:
• limit
Ratelimit: 20 requests per minute
Example Output:
{
"id": "583807014896140293",
"data": [
{
"owners": [
"321714991050784770",
"205680187394752512",
"116930717241311236"
],
"monthly_votes": 32,
"server_count": 68,
"total_votes": 33,
"shard_count": 0,
"monthly_votes_rank": 1025,
"server_count_rank": 3177,
"total_votes_rank": 4708,
"shard_count_rank": 11974,
"timestamp": "2020-08-15T09:00:00.210Z",
"unix_timestamp": 1597482000
},
{
"owners": [
"321714991050784770",
"205680187394752512",
"116930717241311236"
],
"shards": 0,
"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
},
{
"owners": [
"321714991050784770",
"205680187394752512",
"116930717241311236"
],
"shards": 0,
"monthly_votes": 32,
"server_count": 68,
"total_votes": 33,
"shard_count": 0,
"monthly_votes_rank": 1020,
"server_count_rank": 3176,
"total_votes_rank": 4708,
"shard_count_rank": 11974,
"timestamp": "2020-08-15T07:00:00.216Z",
"unix_timestamp": 1597474800
}
]
}
Endpoint: /api/bots/top?sortby=
Query Options:
• votes
• monthly votes
• servers
• shards
Ratelimit: 60 requests per minute
Example Output:
[
{
"certified": false,
"owners": [
"275748765166469120"
],
"deleted": false,
"id": "432610292342587392",
"name": "Mudae",
"def_avatar": "dd4dbc0016779df1378e7812eabaa04d",
"avatar": "29cb28fbf65a3958105026ab03abd306",
"short_desc": "",
"lib": "discord.js",
"prefix": "$",
"website": "https://www.patreon.com/mudae",
"approved_at": "2018-04-21T21:17:57.793Z",
"monthly_votes": 1683828,
"server_count": 666905,
"total_votes": 35867816,
"shard_count": 400,
"monthly_votes_rank": 1,
"server_count_rank": 8,
"total_votes_rank": 1,
"shard_count_rank": 5,
"timestamp": "2020-08-15T09:00:00.210Z",
"unix_timestamp": 1597482000
},
{
"certified": false,
"owners": [
"157605500488384512",
"161693885121298432"
],
"deleted": false,
"id": "282859044593598464",
"name": "ProBot ✨",
"def_avatar": "0e291f67c9274a1abdddeb3fd919cbaa",
"avatar": "156a0d2872579f1ffcaa5d2127239bfd",
"short_desc": "",
"lib": "Eris",
"prefix": "# (Customizable)",
"website": "https://probot.io",
"approved_at": "2017-07-03T20:54:12.930Z",
"monthly_votes": 378285,
"server_count": 593700,
"total_votes": 2154524,
"shard_count": 320,
"monthly_votes_rank": 2,
"server_count_rank": 13,
"total_votes_rank": 5,
"shard_count_rank": 6,
"timestamp": "2020-08-15T09:00:00.210Z",
"unix_timestamp": 1597482000
},
{
"certified": true,
"owners": [
"218508002255306752",
"186199408981835776",
"231459866630291459"
],
"deleted": false,
"id": "469610550159212554",
"name": "ZeroTwo",
"def_avatar": "1cbd08c76f8af6dddce02c5138971129",
"avatar": "49149ed1f8d1292f6dad8746ef66ced9",
"short_desc": "",
"lib": "Discord4J",
"prefix": "zt!",
"website": "http://zerotwo.bot/index.php",
"approved_at": "2018-08-24T01:38:54.254Z",
"monthly_votes": 353327,
"server_count": 450817,
"total_votes": 3573868,
"shard_count": 512,
"monthly_votes_rank": 3,
"server_count_rank": 19,
"total_votes_rank": 4,
"shard_count_rank": 3,
"timestamp": "2020-08-15T09:00:00.210Z",
"unix_timestamp": 1597482000
}
]
Endpoint: /api/auctions/current - Gets the currently active bids.
Endpoint: /api/auctions/tags - Gets all the tags for auctions.
Ratelimit: 60 requests per minute
Example Output:
{
"bot": [
// Array of bot tags
],
"server": [
// Array of server tags
]
}
Endpoint: /api/users/:id/bots
Ratelimit: 60 requests per minute
Example Output:
{
"user": {
"id": "205680187394752512",
"avatar": "11d3cdae2582dc4ad1856e2878e45593",
"def_avatar": "https://cdn.discordapp.com/embed/avatars/1.png",
"tag": "Xignotic#0001"
},
"bots": [
{
"certified": true,
"owners": [
"205680187394752512"
],
"deleted": false,
"id": "461521980492087297",
"name": "Shiro",
"def_avatar": "1cbd08c76f8af6dddce02c5138971129",
"avatar": "9f642706ac70dadb610e791bed68b314",
"short_desc": "",
"lib": "discord.js",
"prefix": "x! (Customizable)",
"website": "https://shiro.gg?ref=topgg",
"approved_at": "2018-09-22T11:25:10.962Z",
"monthly_votes": 125,
"server_count": 28199,
"total_votes": 55662,
"shard_count": 0,
"monthly_votes_rank": 488,
"server_count_rank": 134,
"total_votes_rank": 83,
"shard_count_rank": 2985,
"timestamp": "2020-08-21T00:00:00.204Z",
"unix_timestamp": 1597968000
},
{
"certified": false,
"owners": [
"205680187394752512"
],
"deleted": false,
"id": "559726241280688130",
"name": "DBL Watcher",
"def_avatar": "0e291f67c9274a1abdddeb3fd919cbaa",
"avatar": "daf5c30392b15a91e6db8ac811497a02",
"short_desc": "",
"lib": "discord.js",
"prefix": "watcher ",
"website": "",
"approved_at": "2019-03-25T13:30:06.323Z",
"monthly_votes": 1,
"server_count": 15,
"total_votes": 10,
"shard_count": 0,
"monthly_votes_rank": 9332,
"server_count_rank": 4159,
"total_votes_rank": 7439,
"shard_count_rank": 4611,
"timestamp": "2020-08-21T00:00:00.204Z",
"unix_timestamp": 1597968000
},
{
"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": 33,
"server_count": 67,
"total_votes": 34,
"shard_count": 0,
"monthly_votes_rank": 1156,
"server_count_rank": 3233,
"total_votes_rank": 4716,
"shard_count_rank": 12085,
"timestamp": "2020-08-21T00:00:00.204Z",
"unix_timestamp": 1597968000
}
]
}
Endpoint: /bot/:id/widget/:type
Available Types:
• servers
• totalVotes
• monthlyVotes
• shardCount
• ranks
Query Options:
• ?titleFontSize= - Default: 12
• ?labelFontSize= - Default: 12
• ?backgroundColor= - Default: #00000
• ?textColor= - Default: #FFFFFF
• ?lineColor= - Default: #7289da
• ?width= - Default: 400
• ?height= - Default: 150
Rank Widget Options:
• ?titleColor= - Default: #a8b3dd
• ?rankBackColor= - Default: #1d1e21
• ?rankColor= - Default: #a8b3dd
• ?borderColor= - Default: #a8b3dd69
• ?backgroundColor= - Default: #2a2b2e
• ?width= - Default: 400
• ?height= - Default: 150