Skip to main content
The Top.gg Java SDK is a community-maintained library that wraps the Top.gg REST API for Java applications. It supports posting your bot’s server count and retrieving bot and user information. It is not maintained by the Top.gg core team.

​
Installation

The SDK is published through JitPack. Replace VERSION with the latest release tag or commit hash listed on the releases page.

​
Maven

Add the JitPack repository and the dependency to your pom.xml: 
<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.github.top-gg</groupId>
        <artifactId>java-sdk</artifactId>
        <version>VERSION</version>
    </dependency>
</dependencies>

​
Gradle

Add the JitPack repository and the dependency to your build.gradle: 
repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    implementation 'com.github.top-gg:java-sdk:VERSION'
}

​
What the library supports

  • Posting your bot’s server count to Top.gg
  • Retrieving bot information and server counts
  • Fetching Top.gg user profiles
  • Checking if a specific user has voted

​
Community and support

This library is not maintained by the Top.gg core team. For bug reports or feature requests, open an issue on the GitHub repository. For general API questions, join the Top.gg Discord server at discord.gg/dbl.