> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/discordplace/discord.place/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord Bots

> Discover, vote for, and list Discord bots with rich stats, reviews, and API integration.

The bots directory is discord.place's catalog of Discord bots. You can browse thousands of bots by category, search by keyword, or sort by votes to find the right bot for your server. Bot developers can list their bots, receive vote notifications via webhook, and post live stats through the API.

## Browsing bots

The bots listing page lets you search and filter the catalog in several ways:

* **Search** — enter a bot name or keyword in the search bar
* **Categories** — filter by tags such as Moderation, Music, Fun, Utility, and more
* **Sorting** — order results by vote count, newest, or most servers

Each bot listing shows the bot's name, short description, category tags, vote count, server count, and command count.

## Adding your bot

<Note>
  You must be a member of the discord.place Discord server before submitting a bot. You also need to be the verified owner of the bot application in Discord.
</Note>

<Steps>
  <Step title="Join the discord.place server">
    Join the official discord.place Discord server. Your membership is verified during submission.
  </Step>

  <Step title="Go to the bots page">
    Navigate to [discord.place/bots](https://discord.place/bots) and click **Add your bot**.
  </Step>

  <Step title="Enter your bot's details">
    Provide the following information:

    * **Bot ID** — the application/user ID of your Discord bot
    * **Short description** — a brief one-liner shown in listings
    * **Description** — a full Markdown description of your bot's features
    * **Invite URL** — a valid Discord authorization URL for your bot
    * **Categories** — one or more tags that describe your bot
    * **Webhook URL** *(optional)* — a URL to receive vote notifications
    * **Webhook token** *(optional)* — a secret token sent with webhook payloads
  </Step>

  <Step title="Submit for review">
    Click **Submit**. Your bot enters a review queue. The discord.place team will review and approve or deny it. You will be notified in the Discord server.
  </Step>
</Steps>

<Info>
  If your bot is denied, you must wait 6 hours before resubmitting the same bot.
</Info>

## Voting

Any logged-in user can vote for a bot once every 24 hours. The vote count is displayed on the bot's listing page and increments with each vote. Votes help surface popular bots in search results and rankings.

If you have configured a webhook URL on your bot listing, discord.place will send a POST request to that URL each time someone votes. See [Vote Webhooks](/api-reference/bots/webhooks) for the payload format.

## Reviews

Users can leave a star rating and a text review (64–256 characters) on any approved bot. Reviews are moderated before appearing publicly. Each user can submit one review per bot.

## Bot stats

Your bot listing displays two live statistics:

| Stat              | Description                                   |
| ----------------- | --------------------------------------------- |
| **Server count**  | The number of servers your bot is in          |
| **Command count** | The number of slash commands your bot exposes |

You can update these stats in two ways:

* **API** — send a `PATCH` request from your bot's process using your API key. See [Update Bot Stats](/api-reference/bots/update-stats).
* **Dashboard** — update the values manually from your bot's manage page on discord.place.

<Warning>
  The server count you submit via the API is validated against Discord's approximate guild count. Values that differ too far from the real count are rejected.
</Warning>

## API integration

Generate an API key from your bot's manage page on discord.place to authenticate stat update requests.

<CardGroup cols={2}>
  <Card title="Update Bot Stats" icon="chart-bar" href="/api-reference/bots/update-stats">
    Post server count and command count from your bot's process.
  </Card>

  <Card title="Check Vote" icon="check" href="/api-reference/bots/check-vote">
    Check whether a specific user has voted for your bot.
  </Card>

  <Card title="Vote Webhooks" icon="bell" href="/api-reference/bots/webhooks">
    Receive a POST request every time someone votes for your bot.
  </Card>

  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    Learn how to generate and use your bot's API key.
  </Card>
</CardGroup>