TopStats API Is Now Available

TopStats.gg's API has now been released and is available for use!

TopStats API Is Now Available

With the release of our open beta, we're happy to also announce the availability of our new, faster API!

Developer Docs: https://docs.topstats.gg

Developer Terms: https://topstats.gg/policies/developers

How Do I Start Using The New API?

Super easily! Head over to TopStats.gg and login to the site. Click on your profile at the top right, and then click "Get Token"! Please read over our Developer Terms and Terms of Service and accept them.

Once you've done this, reopen the modal and you will see your API token ready for use!

Image of accessing your API token on our website

Can I use my old DBL Statistics API Token?

No you cannot, you will need to use the new token provided on TopStats.gg.

What Comes With The New API?

Faster Response Times

Our new API has received a significant performance increase with request times cut in half for all routes. No need to wait for our data to arrive!

Route Legacy Initial Req Time Legacy Req Time Initial Req Time Req Time
Bot data 397ms 292ms 134ms 56ms
Bot graph data 12.99s 999ms 153ms 65ms
Rankings/Top 660ms 551ms 193ms 143ms
User Bots 395ms 293ms 185ms 62ms

Please note that these request times can vary depending on numerous factors, it is also important to note that TopStats.gg's API currently does return considerably less data on the graph data route, this may change in the future.

More data

  • We've started to return more data, for example our bot route now returns discord bot tags and a percentage difference for votes!
  • With more data coming on the way...

Check out our docs for more details!

What Happens To The Legacy API (DBL Statistics)

The legacy API is will remain running until we have reworked our widgets API, and more information regarding a deprecation window will follow.

I Want to Contribute!

If you would like to contribute towards our API, you can become a Library Maintainer! If you're interested come join our Discord Server and reach out to us!

Still Need Help?

Sure thing! Head over to our Discord Server and we'll help you out!