POST

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

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

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesdiscordPlatform identifier, fixed value.
actionbodystringYesdirectoryCapability identifier, fixed value.
categorybody.paramsstringNo-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.
limitbody.paramsinteger (1–100)No20The 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

#
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": {}
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

Response example

#
Captured September 26, 2026 at 08:56 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
json
{  "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.

FieldMeaning
idThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
nameName of the object itself, for account, product and business capabilities.
urlLink to the record on the platform.
textBody 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_countKeeps the platform's own meaning
online_countKeeps the platform's own meaning
boost_countKeeps the platform's own meaning
vanity_url_codeKeeps the platform's own meaning
languageContent language code (for example zh, en) as judged by the platform; it can be wrong.
categoriesKeeps the platform's own meaning
keywordsKeeps the platform's own meaning
icon_urlKeeps the platform's own meaning
banner_urlKeeps the platform's own meaning
verification_levelKeeps the platform's own meaning
is_nsfwKeeps the platform's own meaning
created_atCreation time, same format as posted_at.
directory_urlKeeps the platform's own meaning
platformSource 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.

Errors

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

Our own visit stats are always on. Google Analytics loads only if you choose “Allow analytics”. Privacy policy