API Documentation

Integrate DiscordHub data into your applications with our powerful REST API. Get real-time access to bot and server information.

Getting Started

1. Get API Key

Sign up for a Developer account to get your API key

2. Make Requests

Use your API key to authenticate requests to our endpoints

REST API
3. Real-time Data

Access up-to-date bot and server information instantly

Live Data
4. Rate Limits

Respect our rate limits for optimal performance

1000/hour
Base URL
https://api.discordhub.com/v1

Authentication

All API requests require authentication using your API key in the Authorization header:

curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.discordhub.com/v1/bots

Endpoints

GET
/bots

Retrieve a list of Discord bots with optional filtering and pagination.

Query Parameters:

limitNumber of results (max 100, default 20)
offsetPagination offset (default 0)
categoryFilter by category
searchSearch query

Example Response:

{
  "success": true,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "discord_id": "987654321098765432",
      "name": "MusicBot Pro",
      "description": "High-quality music streaming bot",
      "avatar": "https://cdn.discordapp.com/avatars/...",
      "invite_url": "https://discord.com/api/oauth2/authorize?...",
      "server_count": 125000,
      "votes": 2150,
      "rating": 4.9,
      "verified": true,
      "tags": ["music", "entertainment"]
    }
  ],
  "count": 1,
  "total": 1247
}
GET
/bots/{id}

Get detailed information about a specific bot.

GET /bots/123e4567-e89b-12d3-a456-426614174000
GET
/servers

Retrieve a list of Discord servers with optional filtering.

GET /servers?category=gaming&limit=10
GET
/categories

Get all available categories for bots and servers.

GET
/stats

Get platform statistics including total bots, servers, and users.

Rate Limits

Free Tier

100

requests per hour

Premium

1,000

requests per hour

Developer

10,000

requests per hour

SDKs & Libraries

JavaScript/Node.js

Official JavaScript SDK for Node.js and browsers

npm install discordhub-api
Python

Python wrapper for the DiscordHub API

pip install discordhub
Go

Go client library for DiscordHub API

go get github.com/discordhub/go-api

Need Help?

Our developer support team is here to help you integrate with our API successfully.