Servce Notice

As of 27th of February 2021 the fetcher has been started.
You can find out more in Our discord

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