The Official API Clientfor DiscordForge
Interact with the DiscordForge platform programmatically. Search bots, pull analytics, listen for votes – all type-safe and rate-limited out of the box.
1import { ForgeClient } from "discordforge-sdk";23const forge = new ForgeClient({)4 apiKey: process.env.FORGE_API_KEY,5 botId: process.env.FORGE_BOT_ID,6});78// Post stats on startup9await forge.postStats({)10 serverCount: client.guilds.cache.size,11 shardCount: client.shard?.count ?? 1,12});Features
Everything you need to build
on the DiscordForge platform
Type-Safe
Full TypeScript support with auto-generated types from the DiscordForge API. Every response is strictly typed – no guessing.
Built-in Rate Limiting
Automatic request queuing and retry logic. Hit the API as hard as you want – the client handles throttling for you.
Search Everything
Search bots, servers, and users with powerful filters. Sort by votes, member count, tags, verification status, and more.
Webhook Support
Built-in webhook listener for vote events, review notifications, and status changes. Just subscribe and react.
Minimal Footprint
Zero external dependencies. The client is tiny, tree-shakeable, and works in Node.js, Deno, Bun, and edge runtimes.
Analytics Access
Pull your bot's view counts, click-through rates, and vote trends directly. Build dashboards or feed data into your systems.
Code Examples
Ship in minutes,
not hours
The API client is designed to feel native. Every method returns typed responses, handles pagination, and retries failed requests automatically.
1import { ForgeClient } from "discordforge-sdk";2 3const forge = new ForgeClient(4 process.env.FORGE_API_KEY,5 process.env.FORGE_BOT_ID6);7 8// Post stats on bot startup9await forge.postStats({10 serverCount: client.guilds.cache.size,11 shardCount: client.shard?.count ?? 1,12});13 14console.log("Stats posted to DiscordForge!");Ready to build?
Install the package, grab an API key from your DiscordForge dashboard, and start making requests in under a minute.