From d3fb6881790f4f9fecb69eb4d39e791a7f3dbfba Mon Sep 17 00:00:00 2001 From: marco_rennmaus Date: Fri, 29 May 2026 18:22:09 +0200 Subject: [PATCH 1/2] Remove broken or removed endpoints --- api/v0/bots.mdx | 44 -------------------------------------------- 1 file changed, 44 deletions(-) diff --git a/api/v0/bots.mdx b/api/v0/bots.mdx index 57ba071..2f6ed88 100644 --- a/api/v0/bots.mdx +++ b/api/v0/bots.mdx @@ -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: - - - The voter's Discord username. - - - - The voter's Discord Snowflake ID. - - - - The voter's Discord avatar hash. - - - - 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. - - ---- - ## GET /bots/:bot_id/stats Returns server and shard statistics for the specified bot. From e3e05459e5eae078f31f928537b291cabe6f80cc Mon Sep 17 00:00:00 2001 From: marco_rennmaus Date: Fri, 29 May 2026 18:29:41 +0200 Subject: [PATCH 2/2] Remove leftover references --- api/v0/bots.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/v0/bots.mdx b/api/v0/bots.mdx index 2f6ed88..3ddb582 100644 --- a/api/v0/bots.mdx +++ b/api/v0/bots.mdx @@ -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**. Bot endpoints have stricter rate limits than other v0 endpoints. Stay within 60 requests per minute to avoid `429 Too Many Requests` errors.