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

Widget Documentation

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