What is Discord Bot API?

What is Discord Bot API?

How it works

You request an API key, authenticate each request with it, and call endpoints that read or write the same data the dashboard uses: members, points, quests, campaigns, and completions. The usual reason to reach for the API is that community data needs to sit next to product data, in your own warehouse or dashboard, where it can be joined against revenue or retention.

When to use it

Use the API when someone needs community numbers in a report that also contains non-community numbers, or when quest completion must trigger something in your own product.

Worked example

Discord's API enforces rate limits per route, so a bot crediting 300 quest completions has to queue role updates rather than fire them at once. This is why bulk reward crediting shows up over a few minutes instead of instantly, and why a bot that assigns roles to hundreds of members at once is usually the one that gets throttled.

Common mistakes

• Embedding an API key in client-side code, where anyone can read it.
• Polling endpoints on a tight loop instead of respecting rate limits, which gets the key throttled.
• Building a custom dashboard before checking whether the built-in analytics already answer the question.

FAQ