Discord Directory API
API health
- 24h health
- Normal
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
Browse Discord's server directory, with an optional category. Each server has description, member and online counts, Boosts, language, tags and verification level. category accepts gaming, entertainment, education, music or science-and-tech. Unrecognized values are ignored.
Send POST https://api.everyinfra.com/api/v1/social with platform set to discord and action set to directory. Price $1.39 per 1,000 requests ($0.001389 per call). Failed calls and empty results are not charged. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.
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.
AI prompt
#Please help me write a data collection script with the EveryInfra Discord Directory endpoint (discord/directory).
How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to discord and action to directory, and put the parameters inside params.
- No required parameters.
- Optional parameters:
- category: 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: 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. (default: 20)
- Returns a list of records. Main fields of each record: id, name, url, text, member_count, online_count, boost_count, vanity_url_code, language, categories, keywords, icon_url; 17 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=discord.
- Example request body:
{
"platform": "discord",
"action": "directory",
"params": {}
}
- Price: $1.39 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.
Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.Request parameters
#| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | discord | Platform identifier, fixed value. |
action | body | string | Yes | directory | Capability identifier, fixed value. |
category | body.params | string | No | - | 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 | body.params | 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. |
Code samples
#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": {}
}'OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.
Response example
#{ "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": { … }}
Response fields
#Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.
| 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 | Keeps the platform's own meaning |
online_count | Keeps the platform's own meaning |
boost_count | Keeps the platform's own meaning |
vanity_url_code | Keeps the platform's own meaning |
language | Content language code (for example zh, en) as judged by the platform; it can be wrong. |
categories | Keeps the platform's own meaning |
keywords | Keeps the platform's own meaning |
icon_url | Keeps the platform's own meaning |
banner_url | Keeps the platform's own meaning |
verification_level | Keeps the platform's own meaning |
is_nsfw | Keeps the platform's own meaning |
created_at | Creation time, same format as posted_at. |
directory_url | Keeps the platform's own meaning |
platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
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.
Errors and billing
#- 401
- Missing or invalid key.
- 402
- Insufficient balance. Top up first.
- 422
- Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
- 429
- Per-minute request limit reached. Wait for Retry-After, then try again.
- 503
- Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
- 200 empty
- No data. No charge.
Official references
#Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.
- Discord Server Categories and Discovery Scope ↗
Discord official documentation lists community categories such as gaming, music, and entertainment. Supported categories are exactly the ones listed on this page and do not adopt legacy Discovery documentation categories or sorting features.
Checked 2026-09-04