Rank.top
documentation

Get started with Rank.top

List your bot or server, customize its page, and set up vote notifications. For developers, there are webhook examples and an API reference.

Quick links:Getting startedVote webhooksMarkdownAPI reference
POST https://your-bot.example/rank-top-votesAuthorization: your-auth-tokenContent-Type: application/json{  "type": "vote",  "target_type": "bot",  "target_id": "706183309943767112",  "user_id": "283649821047291904",  "is_test": false,  "is_power_vote": false,  "timestamp": 1790620000,  "next_vote_in": 43200}

Sent to your webhook URL every time someone votes.

Set up webhooks
pick a route

Where are you headed?

Choose what you want to do. Each row links to the guides you'll need, in order.

Rank.top docs · route map

List a bot

Add your bot, customize its page, and enable vote alerts.

  1. 1Sign inGetting started
  2. 2Add your botGetting started
  3. 3Add a descriptionMarkdown guide
  4. 4Customize the layoutMarkdown guide
  5. 5Get vote alertsVote webhooks

List a server

Add your server and fill out its listing.

  1. 1Sign inGetting started
  2. 2Add your serverGetting started
  3. 3Add a descriptionMarkdown guide
  4. 4Add links and imagesMarkdown guide
  5. 5Get vote alertsVote webhooks

Handle votes in code

Set up an endpoint to receive vote notifications.

  1. 1Request formatVote webhooks
  2. 2Code examplesVote webhooks
  3. 3Configure the webhookVote webhooks
  4. 4Check the tokenVote webhooks
  5. 5TroubleshootingVote webhooks

Use the API

Read listings and post your bot's stats.

  1. 1Get a keyAPI reference
  2. 2Try a requestAPI explorer
  3. 3Rate limitsAPI reference
  4. 4ErrorsAPI reference
  5. 5SDKsAPI reference
browse by topic

Every guide

Open a guide, or jump to a section using the links below its description.

Part 1

The basics

Account setup and listing customization.

Part 2

Building with Rank.top

API requests, vote notifications, and code examples.

Coming soon

More topics

These guides aren't available yet.

  • Server managementManage your server listing, page settings, and statistics.
  • Bot integrationPost your bot's server count and handle vote notifications.
  • AnalyticsTrack votes, views and how people find your listing.
  • Payments and donationsTake donations and handle payments for your bot or server.
  • Earning from votesRevenue sharing and the factors that affect your earnings.
  • Growing your communityTips for promoting your server and keeping members active.

Still stuck?

If you can't find an answer, ask us.

Help centerAnswers to common questions.Ask on DiscordGet help from the community.Contact usSend a message to our team.Service statusCheck for outages.