Top.gg Vote API: How Voting Works on the Discord Bot List
Top.gg is a search-and-discovery website where anyone can list Discord bots, and its listings are sorted by the upvotes site users have given them. A logged-in user can vote for a bot every 12 hours; each vote normally raises the count by one, except on weekends. Its guidelines forbid automated voting programs and let owners reward users for voting for their own bot. Developers receive every event through the top gg vote api, which delivers notifications as HTTP POST requests to a webhook address.
Published by BuyingVotes editorial desk ยท Current as of
Top.gg as a Discord bot list: what the site does
Top.gg is a search-and-discovery website where anyone can list their Discord bots. That single sentence, from the platform's own quick start guide, covers what the service is: a directory where bot owners present their work and users look for bots to add to a server. Nothing is sold on the listing pages, and no application form stands between a bot and the directory.
Ranking decides who gets seen. When looking for bots on Top.gg, they are sorted by the amount of upvotes they have received from people who use the site. Vote figures sit publicly beside the listings, and the comparison pages add a monthly votes measure, which the platform describes as a sign of user activity: projects with more votes tend to have more users.
The voting mechanic is deliberately small. Each bot page carries a Vote button in the upper right corner, and clicking it takes the user to the vote page for that specific listing. One press, one login check, one count that normally rises by one, except on weekends. Everything else on the platform, from reward commands to the api, builds on that one action.
- The leaderboard decides where a bot appears when a visitor browses the directory, because the sorting key is the upvote total rather than age, size or any measure the owners set.
- The published count works as social proof: a visitor comparing two bots sees one figure for each and can pick without installing either.
- The comparison view adds a monthly votes measure, which the platform presents as a sign of user activity, and projects with more votes tend to have more users.
- A vote is free for the user, and its only direct cost is the 12-hour wait before the same bot can be voted for again.
Voter flow and the 12-hour cycle
Two gates stand between a visitor and a counted vote. The first is the login: Top.gg requires users to be logged in to vote for a bot. The second is time. A user cannot vote again for the same bot or server until 12 hours have passed since their last vote, which the support pages sum up as voting twice a day.
What does a vote actually do? When voted for, the bot or community's votes increase by one, except on weekends. That is the whole transaction on the platform side: one press, one point, one timer. The support pages note the weekend exception openly and leave it at that, so any figure seen on a Saturday or Sunday should be read with that note in mind.
Bumping is a different action and worth separating from voting, because people often arrive with the two mixed. A vote goes to a bot or server listing through the Vote button and follows the 12-hour cycle. A bump renews a listing's visibility and lives on its own timer. The two support different goals, and neither can replace the other. A reader who wants to help a specific bot should find its page and vote; a reader who maintains a listing keeps to the bump schedule that applies to it.
- The 12-hour clock runs per bot, not per account: a vote for a second bot does not wait for the first timer.
- Weekend behaviour is different, and the support pages flag it without publishing the weekend formula.
- Vote figures appear next to listings, so a reader can see a bot's total before adding it to a server.
- Rewards, where a developer offers them, are claimed inside the bot on Discord, not on the website.
How the vote api delivers the vote event
The developer side is where the top gg vote api comes in. When a user votes for a bot or server on Top.gg, the platform sends an HTTP POST request to a URL the owner has specified. In other words, the platform does not wait for a bot to ask whether anything happened; it pushes the event out the moment it occurs.
Webhooks are the recommended way to react to votes in real time, and that recommendation comes from the platform's own developer documentation rather than from third parties. Polling remains possible, but the published guidance prefers the push model. A developer who wants to know within seconds that a vote landed registers a webhook and lets the platform call it.
This is also the piece owners use when they connect vote rewards. The vote api carries the signal; what the owner does with it, from a simple thank-you message to a reward command, sits in the bot's own code and under the platform's rules. The api covers the notification and the counting. What owners may offer voters belongs to the guidelines, and what happens when manipulation creeps in belongs to enforcement.
- Vote notifications arrive as HTTP POST requests, so a small server or serverless function can receive them.
- A webhook endpoint needs no user interaction once it is set up; the developer registers it and the platform calls it.
- Webhooks are the recommended way to react to votes in real time, ahead of polling the api on a schedule.
- The count shown on the website is maintained by Top.gg itself; the webhook only tells the developer that another event arrived.
Vote rewards and the vote api across bots
The vote api signal is identical for every listing, which is why a question about a specific bot usually has the same answer. Vote for Mudae, for Poketwo, for Lara or for OwO, and the flow stays the same: log in, open the listing, press the Vote button, wait 12 hours for that bot. What differs between bots is only what the developer does with the notification.
Cricket Guru's own listing shows the pattern in miniature. The page names a cgvote command, used to vote for the bot and claim vote rewards, and a cgreminder command, which sets a vote reminder on a 12-hour cycle. That second command exists because the timer is per bot and per 12 hours; the bot itself helps its users come back when the next window opens. Not every developer builds the same pair of commands. Some answer a vote with a message in Discord, some grant in-bot currency, and some grant nothing. The platform records the event; the owner decides the reward.
- Cricket Guru names a cgvote command on its listing, used to vote and claim vote rewards.
- Cricket Guru pairs that command with cgreminder, which sets a vote reminder every 12 hours.
- Dank Memer, Mudae, Poketwo, Lara and OwO are all voted for through the same website flow and receive the same webhook signal.
- Only the developer decides whether an event produces a reward, a message or nothing at all.
What the guidelines allow
The platform's voting guidelines draw a line in two sentences. Owners may reward users for voting for their own bot. Bots may not incentivise users to vote for other entities. The first sentence is why reward commands exist at all; the second is why a bot cannot demand a vote for a different listing in exchange for anything.
The same guidelines name the one method that voids work outright: bots or other programs that allow a user or others to cast votes automatically for listed products are prohibited. Automated activity is the thing the guidelines target, and a vote that arrives through such a program is a vote the platform can throw away.
The guidelines also set the spirit of the system. Voting should be used as an enhancement or an added bonus for the bot, not as a requirement for most of its features. That sentence is addressed to developers, and it explains why so many bots remain fully usable by people who never vote at all. The api hands a developer the event; the guidelines stop that event from becoming a paywall for the bot's basic work.
- Rewards are allowed only for a bot's own listing, and only within the limits the guidelines set.
- Incentivising users to vote for other entities is a separate prohibition, named in its own clause.
- Votes the platform ties to automated programs can be voided, which leaves a listing's count unreliable until corrected.
- The guidelines say plainly that voting should enhance a bot rather than be required for most of its features.
What the platform can see and what it voids
The mechanics of the site make one point hard to escape: a vote is tied to a logged-in account and a per-bot timer, and both sit on Top.gg's side of the system. The platform can see that an account exists, that a timer has or has not run out, and that a count has moved. Those are the ordinary checks, and they run on every vote without anyone asking for them.
Enforcement goes a step further for automated activity. The guidelines prohibit bots or other programs that allow a user or others to cast votes automatically for listed products. A vote tied to such a program is a vote the platform can void, and a listing that leans on voided support ends up with a number it cannot keep. The guidelines do not publish every check the platform runs, and nothing here can promise what its systems will or will not catch. What they do publish is the rule and the consequence, which is the honest limit of what a directory can say.
For a voter, the practical reading is short. Vote inside the rules, from your own account, once per 12 hours per bot, and the count does what the mechanics say it does. Anything that arrives outside that path is support the platform has already named as voidable.
- Every vote runs through a logged-in account, so the platform always has an identity attached to each event.
- The 12-hour timer is enforced by the site itself, not by the bot developer.
- Votes arriving through automated programs are prohibited and can be voided under the guidelines.
- The support pages name the tooling ban without listing every check the platform runs.
When a vote does not register
Most reports of a missing vote come down to the timer. The support page says it directly: if it has not been 12 hours since the last vote for that bot or server, the site will not accept another until the timer is over. The button may still be visible on the page, and pressing it changes nothing until the window reopens.
The second block is the login. Top.gg requires users to be logged in to vote, so a session that has lapsed produces a silent refusal. Logging in again and returning to the listing is the fastest test. Weekend behaviour is the third difference worth remembering, since the platform says counts work differently on weekends without explaining every detail of the difference.
One more mismatch belongs to the developer side rather than the voter: a webhook that never fires. That is a configuration question about the endpoint address the owner registered, not a failure of the count. The platform records the vote either way, and the api notification is a separate delivery that each owner has to set up for themselves.
- Timer exhausted: less than 12 hours since the last vote for that bot or server, so the site will not accept another yet.
- Login missing: an anonymous visitor cannot vote at all, so the button will refuse the request.
- Weekend in progress: counts behave differently on weekends, which the support pages note without publishing details.
- Reward missing: a claim that never arrives is a developer question, because the platform records the event and the owner decides the payout.
| Mechanic | What the platform publishes | What it means in practice |
|---|---|---|
| Login gate | Users must be logged in to vote | Anonymous visitors are refused before the count |
| Timer | One vote per bot every 12 hours | Twice a day for the same listing at most |
| Count effect | A vote raises the count by one, except on weekends | Weekend figures follow a different pattern |
| Vote button | Upper right corner of each bot page | Leads to the vote page for that listing |
| Developer side | Vote api sends HTTP POST to a URL the owner sets | Webhooks are the recommended real-time option |
| Rewards | Owners may reward users for voting for their own bot | Bots may not incentivise votes for other entities |
| Automated voting | Bots or programs that vote automatically are prohibited | Votes from such programs can be voided |
What to do
-
Open the bot's listing page
Find the bot through the directory's search or browse the sorted listings. Vote figures sit beside each entry, so a reader can compare bots before choosing one to support.
-
Log in before voting
Top.gg requires users to be logged in to vote for a bot. A visitor without an accepted session cannot pass this gate, and the site will refuse the request until the login is done.
-
Press the Vote button
Each bot page has a Vote button in the upper right corner. Clicking it takes the user to the vote page for that specific listing, where the vote is confirmed and counted.
-
Claim a reward if the bot offers one
Dank Memer, Mudae, Poketwo, Lara, OwO and Cricket Guru handle rewards differently, so follow the instructions on the listing. Cricket Guru names a cgvote command for claiming vote rewards; other bots publish their own commands or give none.
-
Set a reminder for the next vote window
The timer runs for 12 hours per bot. Cricket Guru's cgreminder command sets a reminder every 12 hours, and any ordinary reminder serves the same purpose. Treat bumping as a separate action on its own schedule.
Frequently asked
What is Top.gg?
Top.gg is a search-and-discovery website where anyone can list a Discord bot. Listings are sorted by the upvotes people who use the site have given them, and vote figures sit beside each listing, so a visitor can see at a glance which bots pull the most support.
How do you vote on Top.gg?
Log in first, because Top.gg accepts no vote from an anonymous visitor. Find the bot's listing, press the Vote button in the upper right corner of the page, and confirm. The count normally rises by one, except on weekends, and a 12-hour timer starts for that bot.
How often can you vote for a Discord bot?
Every 12 hours per bot, which the support pages sum up as twice a day. The timer runs per listing: another bot can be voted at once, but the same bot refuses a second vote until the full 12 hours have passed.
How does the top gg vote api work?
The vote api is the developer side of the same action. When a user votes for a bot or server, Top.gg sends an HTTP POST request to a URL the owner has specified, and webhooks are the recommended way to react to votes in real time rather than polling.
Why is Top.gg vote not working?
The most common block is the 12-hour timer itself. If less than 12 hours have passed since the last vote for that bot or server, the site will not accept another until the timer is over. A missing login is the second frequent cause.
How do you bump on Top.gg?
Bumping and voting are different actions on Top.gg, and the platform treats them separately. A bump renews a listing's visibility on its own timer, while a vote follows the 12-hour cycle. Anyone who wants to support a bot should cast a vote; bumping belongs to listing maintenance.
What is a Discord bot list?
A Discord bot list is a directory where bot owners present their work and users find new bots. Top.gg is one such list. Its rules ban automated vote programs, allow owners to reward users for voting for their own bot, and forbid incentivising users to vote for other entities.
What do vote rewards mean for Mudae, Dank Memer and other bots?
Every bot on the platform, whether Mudae, Dank Memer, Poketwo, Lara or OwO, shares one mechanism: the vote api records the event, and the developer decides what a voter receives. Reward commands such as Cricket Guru's cgvote exist only where an owner has chosen to offer them.
Cited sources
- top.gg. top.gg/bot/1011135011413577768/vote.
- support.top.gg. support.top.gg/support/solutions/articles/73000548596-what-is-voting-.
- support.top.gg. support.top.gg/support/solutions/articles/73000548596-what-is-voting-.
- top.gg. top.gg/tag/vote.
- support.top.gg. support.top.gg/support/solutions/articles/73000548596-what-is-voting-.
No part of these pages teaches or assists automated voting. The guidelines forbid bots and other programs that cast votes automatically, so the pages cannot describe tools for it, cannot promise that manipulated activity goes unnoticed, and cannot quote prices. Reward rules belong to the platform and to each developer.
Reddit prohibits vote manipulation and counts using voting services, or asking people to vote on specific posts for personal gain, as manipulation. Product Hunt prohibits asking for upvotes, using bots and incentivizing upvotes. The Search for a Champion rules void votes from commercial contest subscriptions and vote-swapping sites, and the organiser may disqualify the entrant.
support.reddithelp.com help.producthunt.com championautoparts.com
Hacker News says it uses software to detect and protect against voting rings, and that its anti-abuse software drops some votes. IMDb says it may apply a different weighting calculation when it detects unusual rating activity. Ordinary participation is a spread of unconnected people voting at different times, which is the baseline these systems measure against, and this describes their checks without offering any way past them.
The documents cited here are platform terms, so the consequences they state are contractual: removal, vote resets, suspension, delisting or account termination. Hyvote prohibits vote manipulation, including buying or selling votes for a server listing. Whether a payment for votes is also lawful in a given country is outside these sources and belongs to a lawyer. Boards whose terms bar paid votes, contests that void them and political ballots are refused.
Once voting closes, an order for a board or contest that has not reached its published count is refunded for the part not delivered. Nothing is refunded for action by the platform: Hytale Servers says servers found manipulating votes face vote resets, suspension, delisting or account termination, and TopG may reset votes and freeze a listing when it catches cheating. No rank or result is promised.