Skip to content

Remove v0 endpoints that are no longer working #11

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
marcorennmaus wants to merge 2 commits into
base: main
Choose a base branch
from
+2 −46
Open

Remove v0 endpoints that are no longer working #11

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d3fb688
Remove broken or removed endpoints
marcorennmaus May 29, 2026
e3e0545
Remove leftover references
marcorennmaus May 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 2 additions & 46 deletions api/v0/bots.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: "Bot Endpoints — Top.gg v0 API"
sidebarTitle: "Bots"
description: "Search bots, fetch individual bot details, retrieve voter lists, check vote status, read stats, and post server counts using the Top.gg v0 bot endpoints."
description: "Search bots, check vote status, read stats, and post server counts using the Top.gg v0 bot endpoints."
---

The bot endpoints let you search the Top.gg bot directory, retrieve details for a specific bot, check vote history, and post server count statistics. All bot endpoints require a valid Top.gg token and are subject to a rate limit of **60 requests per minute**.
The bot endpoints let you search the Top.gg bot directory, check vote history, and post server count statistics. All bot endpoints require a valid Top.gg token and are subject to a rate limit of **60 requests per minute**.

<Warning>
Bot endpoints have stricter rate limits than other v0 endpoints. Stay within 60 requests per minute to avoid `429 Too Many Requests` errors.
Expand Down Expand Up @@ -63,50 +63,6 @@ curl "https://top.gg/api/bots?limit=10&sort=-points" \

---

## GET /bots/:bot_id

Returns a single Bot object by its Discord application ID. Returns `404 Not Found` if no bot with that ID is listed on Top.gg.

```bash
curl https://top.gg/api/bots/264811613708746752 \
-H "Authorization: your-topgg-token-here"
```

See the [Bot structure](#bot-structure) section below for the full list of fields.

---

## GET /bots/:bot_id/votes

Returns the last 1000 unique voters for the specified bot. Each entry includes the voter's username, Discord user ID, and avatar hash.

```bash
curl https://top.gg/api/bots/264811613708746752/votes \
-H "Authorization: your-topgg-token-here"
```

### Response

Returns an array of voter objects:

<ResponseField name="username" type="string" required>
The voter's Discord username.
</ResponseField>

<ResponseField name="id" type="string" required>
The voter's Discord Snowflake ID.
</ResponseField>

<ResponseField name="avatar" type="string" required>
The voter's Discord avatar hash.
</ResponseField>

<Warning>
This endpoint returns only the **last 1,000 unique voters** and does not include double votes or weekend bonus votes. If your bot receives more than 1,000 votes per month, you must use [webhooks](/webhooks/overview) and maintain your own vote cache instead of relying on this endpoint.
</Warning>

---

## GET /bots/:bot_id/stats

Returns server and shard statistics for the specified bot.
Expand Down