| title | Top.gg Developer Docs: API, Webhooks, and SDKs |
|---|---|
| description | Everything you need to integrate with Top.gg: REST API reference, webhooks, vote tracking, and community SDKs for Discord bots and servers. |
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.
Learn how Top.gg works and make your first API call in minutes. Get your API token and authenticate requests to the Top.gg API. Receive real-time vote notifications sent directly to your server. Full reference for all v1 and legacy v0 REST API endpoints. Use the official `@top-gg/sdk` npm package to post stats and handle webhooks. Install `topggpy` for automated stats posting and webhook support. SDKs available for .NET, Java, Go, Rust, PHP, and Ruby. Understand API rate limits to keep your integration running smoothly. Add your Discord bot or server to Top.gg from the dashboard. Users can then discover and vote for your project. Navigate to your project's **Integrations & API** settings page to obtain your Top.gg API token. Use the API or an SDK to periodically post your bot's server count. This keeps your listing up to date and improves ranking. Set up a webhook endpoint to receive real-time `vote.create` events whenever a user upvotes your project.