Discord Directory API
Browse public Discord servers by category without knowing a name or an invite link first. Each row has name, categories, language, text and url, for $1.39 per 1,000 calls.
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.
categorytakesgaming,entertainment,education,musicorscience-and-tech.- Without
category, no category is applied. - Failed calls and empty results are not charged.
API health
- 24h health
- Normal
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "discord", "action": "directory", "params": {} }2JSON response
{ "results": [ { "name": "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 }, … ], "count": 20 }3Rows
name text member_count online_count Midjourney The official server for Midjourney, a text-to-image AI where your imagination is the only limit. 18557200 735634 Steal a Brainrot Welcome to the official Steal a Brainrot server! 🧠 7752624 292420 4CSV
discord-directory-sample.csv id,name,url,text,member_count,online_count,boost_count,vanity_url_code,language,categories,keywords,icon_url,banner_url,verification_level,is_nsfw,created_at,directory_url,platform
category goes in, and the servers of that category come back; each row in results is one server, listed as a field table and a CSV file.What data you get
The table shows a real call with no parameters, captured September 26, 2026 at 08:56 (UTC), that returned 20 rows; gray bars mark removed personal information (••• in the CSV). Your own calls return these fields as listed in the field reference.
| id | name | url | text | member_count | online_count | boost_count | vanity_url_code | language | categories | keywords | icon_url | banner_url | verification_level | is_nsfw | created_at | directory_url | platform |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Midjourney | https://discord.gg/midjourney | The official server for Midjourney, a text-to-image AI where your imagination is the only limit. | 18557200 | 735634 | 250 | null | en-US | ["Entertainment"] | ["AI","artificial intelligence","art"] | https://cdn.discordapp.com/icons/662267976984297473/39128f6c9fc33f4c95a27d4c601ad7db.png?size=256.webp?size=256 | https://cdn.discordapp.com/banners/662267976984297473/63249e6867f276efc07d32793b7b3b5a.webp?size=480 | COMMUNITY, DISCOVERABLE, VERIFIED | null | null | https://discord.com/servers/midjourney-662267976984297473 | discord | |
| Steal a Brainrot | https://discord.gg/brainrots | Welcome to the official Steal a Brainrot server! 🧠 | 7752624 | 292420 | 536 | null | en-US | ["Memes","Gaming"] | ["brainrot","roblox"] | https://cdn.discordapp.com/icons/1376018788041887795/f9f69ceda1bb918075ee1b2fd4cb5fcc.png?size=256.webp?size=256 | https://cdn.discordapp.com/banners/1376018788041887795/a8e25be1082189e0a535f86e5d601126.webp?size=480 | COMMUNITY, DISCOVERABLE | null | null | https://discord.com/servers/steal-a-brainrot-1376018788041887795 | discord |
Use cases
Build a shortlist by category
Set
categorytogaming, readname,textandmember_count, and list the candidate gaming communities.Compare servers in different categories
Call with different
categoryvalues and comparemember_countandonline_countof the server rows that come back.Group by language
Read
languagein the rows and split the candidate communities by language.
Discord Help Center (Discover page) vs EveryInfra
Here is how the Discord Help Center and EveryInfra directory compare on categories.
| Compared | Discord Help Center (Discover page) | EveryInfra |
|---|---|---|
| Categories | "In Servers, you can browse various server categories like gaming, music, entertainment, and more by selecting from the category bar located at the top of the Servers page." | category takes gaming, entertainment, education, music or science-and-tech. Without it, no category is applied, and a value that is not listed is ignored. |
The quotes come from the Discover Tab page of the Discord Help Center, checked on 2026-11-22. The page shows no update date. Official sources: Discover Tab
Limits and gotchas
categoryaccepts onlygaming,entertainment,education,musicandscience-and-tech. Without it, no category is applied. A value that is not listed is ignored, so you cannot filter by any tag.limitgoes up to 100.- The result is a list of server rows, not a category tree and not full statistics for each category.
categoriesin a row holds the server's own category tags. It has more values than the five you can pass incategory(for exampleMemes).
Pricing
You pay $0.001389 per call, not per row. Failed calls and empty results are not charged.
| Calls | Cost |
|---|---|
| 10,000 | $13.89 |
| 100,000 | $138.89 |
| 1,000,000 | $1,388.89 |
Totals use the list price per call.
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.
API reference
See the parameters, response fields, errors and billing for directory, and copy the page or open it as Markdown for an AI assistant.
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. |
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). |
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
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.
What fields does the directory API return?
Each row has id, name, url, text, member_count, online_count, boost_count, vanity_url_code, language, categories, keywords, icon_url, banner_url, verification_level, is_nsfw, created_at and directory_url.
How much does it cost to browse one category?
It costs $0.001389 per call, or $1.39 per 1,000 calls, billed per call and not per row. Failed calls and empty results are not charged.
Can I filter by language?
There is no parameter for language. language is a result field, so group the rows by it after you read them.
Related Discord endpoints
You can call the other Discord endpoints with the same EveryInfra API key.
- Search
search$1.39 per 1,000 callsFind Discord servers that match a keyword. - Server
server$1.39 per 1,000 callsResolve a Discord invite code or link to its server's name, description, member and online counts, Boosts, verification level, channel, inviter and expiry. - User search
search_users$1.39 per 1,000 callsLook up Discord users by username or display name and get each account's ID, avatar, Clan tag, creation date, and server and invite counts.