# Discord Bot List API

> Post server counts, publish commands, read votes and receive vote webhooks from discordbotlist.lol.

- [Discord Bot List API](https://docs.discordbotlist.lol/index.md): Post your server count, publish your commands, and check whether somebody voted — in about five minutes.
- [Authentication](https://docs.discordbotlist.lol/authentication.md): One token, one listing, and the reason a wrong bot id answers 404.
- [Errors and rate limits](https://docs.discordbotlist.lol/errors.md): Five status codes, what each one means here, and how to back off.
- [Post the server count](https://docs.discordbotlist.lol/api-reference/bot/post-the-server-count.md): Report how many servers the bot is in. Rate limit: 60 requests per minute per token, which is well above one post per shard per interval.
- [Publish the commands](https://docs.discordbotlist.lol/api-reference/bot/publish-the-commands.md): Replace the commands shown on the bot's page. PUT rather than POST on purpose: a bot that removed a command has to be able to say so, and a merge would leave the removed one on the page with nothing able to delete it.
- [Check a user vote](https://docs.discordbotlist.lol/api-reference/votes/check-a-user-vote.md): Answers whether a user is inside their current 12-hour vote window. This is the endpoint that makes vote-for-perks possible, so its limit is the highest on the API: 600 requests per minute per token.
- [Recent votes](https://docs.discordbotlist.lol/api-reference/votes/recent-votes.md): The vote log, newest first. Read from the append-only event log rather than the one-row-per-user table, which is the only place the history exists.
- [Vote count badge](https://docs.discordbotlist.lol/api-reference/public/vote-count-badge.md): An embeddable badge, public and unauthenticated: the point is to be pasted into a README where no credential can be kept, and it exposes only the vote count, which is already on the public bot page.
- [Official libraries](https://docs.discordbotlist.lol/guides/libraries.md): A JavaScript and a Python client, so the whole integration is four lines instead of forty.
- [Autoposting your server count](https://docs.discordbotlist.lol/guides/autoposting.md): With a library you already use, or with six lines and setInterval.
- [Vote webhook](https://docs.discordbotlist.lol/guides/vote-webhook.md): We POST to your URL the moment somebody votes. Signed, retried five times over about two and a half hours.
- [Vote rewards](https://docs.discordbotlist.lol/guides/vote-rewards.md): Gate a perk behind a vote, with the two endpoints that exist for it.

## OpenAPI Specs

- [openapi](/openapi.json)