Introduction

Our v0 API is HTTPS/REST for general operations such as sending POST requests and receiving GET requests.

Base Url

https://top.gg/api

Authentication

To access our API you need to authorize yourself, this can be done by using your top.gg token. Your token can be obtained from your bot page settings under Integrations & API (https://top.gg/bot/:yourbotid/dashboard/integrations replacing :yourbotid with the ID of your bot).

Authentication is performed with the Authorization HTTP header as such

{
  "Authorization": "your-topgg-token-here"
}