Getting Started
Introduction
What discord-botlists is and why it exists.
discord-botlists is a zero dependency SDK that connects your Discord bot to every botlist at once. It posts your server and shard counts in each list exact wire format, receives votes, comments, reviews and ratings in realtime through one webhook server, parses any list API response into a single normalized shape, and tracks the health of every list it supports.
- Post stats to 30+ verified live lists with one call, each mapped to its exact endpoint, auth header and field names.
- Realtime typed events for votes, comments, reviews and ratings. No polling, no delay.
- Universal parser: fetchBot returns the same UniversalBot shape on every list.
- Status tracking: hourly probes detect deprecated and shutdown lists, prune them from the registry automatically, and show latency on the status page.
- Fully typed with strict TypeScript. Zero runtime dependencies. Node 18+ and Bun.
Infov1.0.3 is a complete rewrite. The old express based class from 1.x is gone; see the migration section if you are coming from v1.