Skip to main content
Top.gg is the largest discovery platform for Discord bots and servers. As a developer, you can use the Top.gg API to post bot statistics, track votes, receive real-time vote notifications via webhooks, and build approved integrations that connect your service with thousands of listings.

Get Started

Learn how Top.gg works and make your first API call in minutes.

Authentication

Get your API token and authenticate requests to the Top.gg API.

Webhooks

Receive real-time vote notifications sent directly to your server.

API Reference

Full reference for all v1 and legacy v0 REST API endpoints.

​
Choose Your Path

JavaScript / Node.js

Use the official @top-gg/sdk npm package to post stats and handle webhooks.

Python

Install topggpy for automated stats posting and webhook support.

Other Libraries

SDKs available for .NET, Java, Go, Rust, PHP, and Ruby.

Rate Limits

Understand API rate limits to keep your integration running smoothly.

​
How It Works

1

List your project

Add your Discord bot or server to Top.gg from the dashboard. Users can then discover and vote for your project.
2

Get your API token

Navigate to your project’s Integrations & API settings page to obtain your Top.gg API token.
3

Post bot stats

Use the API or an SDK to periodically post your bot’s server count. This keeps your listing up to date and improves ranking.
4

Track votes

Set up a webhook endpoint to receive real-time vote.create events whenever a user upvotes your project.