# Discord Directory API (discord.directory)

- Canonical page: [https://everyinfra.com/en/discord-api/directory](https://everyinfra.com/en/discord-api/directory?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "discord", "action": "directory", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 100 per call
- Mode: sync; add "mode": "async" for slow tasks

Discord Directory lists public servers from Discord's server directory, optionally narrowed to one `category`, and returns each server's name, description, member and online counts, Boost count, language, categories and keyword tags, verification level, NSFW flag, creation time, icon, banner and links. It answers which public communities exist around a theme and how lively they are, for community managers benchmarking their own server, game and media marketers looking for where their audience gathers, and researchers mapping communities by topic.

Judge activity by the share of members online, `online_count` over `member_count`, which says more than the member total alone. `boost_count` counts the paid Boosts members have given, and a `vanity_url_code` shows the server has reached a Boost level threshold. `language` is the platform's own judgment and can be wrong, and `verification_level` describes the entry threshold for new members.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=discord&action=directory

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| category | not declared | no | not declared | Filters server discovery in directory using preset values: gaming, entertainment, education, music, or science-and-tech. Leaving this unassigned returns unfiltered directory results; unrecognized categories are ignored. |
| limit | integer (1–100) | no | 20 | The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| name | Name of the object itself, for account, product and business capabilities. |
| url | Link to the record on the platform. |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| member_count | platform-native meaning |
| online_count | platform-native meaning |
| boost_count | platform-native meaning |
| vanity_url_code | platform-native meaning |
| language | Content language code (for example zh, en) as judged by the platform; it can be wrong. |
| categories | platform-native meaning |
| keywords | platform-native meaning |
| icon_url | platform-native meaning |
| banner_url | platform-native meaning |
| verification_level | platform-native meaning |
| is_nsfw | platform-native meaning |
| created_at | Creation time, same format as posted_at. |
| directory_url | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "discord",
  "action": "directory",
  "params": {}
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "discord",
        "action": "directory",
        "params": {},
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "discord",
  "action": "directory",
  "results": [
    {
      "id": "•••",
      "name": "Midjourney",
      "url": "https://discord.gg/midjourney",
      "text": "The official server for Midjourney, a text-to-image AI where your imagination is the only limit.",
      "member_count": 18557200,
      "online_count": 735634,
      "boost_count": 250,
      "language": "en-US",
      "categories": [
        "Entertainment"
      ],
      "keywords": [
        "AI",
        "artificial intelligence",
        "art"
      ],
      "icon_url": "https://cdn.discordapp.com/icons/662267976984297473/39128f6c9fc33f4c95a27d4c601ad7db.png?size=256.webp?size=256",
      "banner_url": "https://cdn.discordapp.com/banners/662267976984297473/63249e6867f276efc07d32793b7b3b5a.webp?size=480",
      "verification_level": "COMMUNITY, DISCOVERABLE, VERIFIED",
      "directory_url": "https://discord.com/servers/midjourney-662267976984297473",
      "platform": "discord"
    },
    {
      "id": "•••",
      "name": "Steal a Brainrot",
      "url": "https://discord.gg/brainrots",
      "text": "Welcome to the official Steal a Brainrot server! 🧠",
      "member_count": 7752624,
      "online_count": 292420,
      "boost_count": 536,
      "language": "en-US",
      "categories": [
        "Memes",
        "Gaming"
      ],
      "keywords": [
        "brainrot",
        "roblox"
      ],
      "icon_url": "https://cdn.discordapp.com/icons/1376018788041887795/f9f69ceda1bb918075ee1b2fd4cb5fcc.png?size=256.webp?size=256",
      "banner_url": "https://cdn.discordapp.com/banners/1376018788041887795/a8e25be1082189e0a535f86e5d601126.webp?size=480",
      "verification_level": "COMMUNITY, DISCOVERABLE",
      "directory_url": "https://discord.com/servers/steal-a-brainrot-1376018788041887795",
      "platform": "discord"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### Which categories can I filter by?

Discord Directory's `category` accepts gaming, entertainment, education, music and science-and-tech. Leave it out to list servers from every category. A category the directory does not recognize is ignored rather than rejected, so a typo quietly gives you unfiltered results; check the spelling, and do not expect arbitrary tags to work as filters.

### How do I tell an active server from a large but quiet one?

Compare `online_count`, the members online at the time of the call, with `member_count`, the total. A high share online says more about activity than a large total. `boost_count`, the number of paid Boosts members have given the server, adds a second sign of how invested its community is.

### How do I find a specific server or read one in detail?

Discord Directory browses by category. To find servers by name or topic, use the Discord Search capability, which searches the public server directory by keyword. To read one server from an invite, pass the invite code or a discord.gg link to the Discord Server capability; it reads public details and does not join the server for you.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=discord
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
