Discord Search API
Search the public Discord server directory by keyword and get name, text, member_count, online_count, categories and url for each server, for $1.39 per 1,000 calls.
categoriesandkeywordsare the category and keyword tags of a server.limitgoes up to 100.- 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": "search", "params": { "keyword": "game development" } }2JSON response
{ "results": [ { "name": "Krunker Bunker", "text": "The official Krunker.io Discord server! Your hub for game development, trading, giveaways, and chatting!", "member_count": 192954, "online_count": 6754 }, … ], "count": 20 }3Rows
name text member_count online_count Krunker Bunker The official Krunker.io Discord server! Your hub for game development, trading, giveaways, and chatting! 192954 6754 InfinitySports Official discord server for the ROBLOX game development studio InfinitySports 156670 17822 4CSV
discord-search-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
keyword goes in, and the matching servers 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 for game development, 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 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Krunker Bunker | https://discord.gg/krunker | The official Krunker.io Discord server! Your hub for game development, trading, giveaways, and chatting! | 192954 | 6754 | 21 | null | en-US | ["LFG"] | ["Game","Gaming","Krunker"] | https://cdn.discordapp.com/icons/448194623580667916/307504ce3821a7b6ffd605b21dc996a8.png?size=256.webp?size=256 | https://cdn.discordapp.com/banners/448194623580667916/b77e42c8e9069afa2fbdcee16a23adfc.webp?size=480 | COMMUNITY, DISCOVERABLE, VERIFIED | null | null | https://discord.com/servers/krunker-bunker-448194623580667916 | discord | |
| InfinitySports | https://discord.gg/infinitysports | Official discord server for the ROBLOX game development studio InfinitySports | 156670 | 17822 | 102 | null | en-US | ["Esports"] | ["basketball","football","hockey"] | https://cdn.discordapp.com/icons/1102970117853282374/ddccd7682a0870316aa7c477b00fb259.png?size=256.webp?size=256 | https://cdn.discordapp.com/banners/1102970117853282374/d42d8db7fa0b142d5c23c3f0ff56eb2a.webp?size=480 | COMMUNITY, DISCOVERABLE | null | null | https://discord.com/servers/infinitysports-1102970117853282374 | discord |
Use cases
Find similar communities to compare with
Search the topic word of your product and compare
member_countandonline_countto see how large similar communities are.Find communities where your audience gathers
Read
text,categoriesandkeywordsto pick servers that fit your audience, then followurlto look at them.Leave out adult servers first
Read
is_nsfwto drop servers with adult content, then look at what is left.See communities by language
Group by
languageto see in which languages a topic is active. The platform setslanguage, so it can be wrong.
Discord Developer Documentation vs EveryInfra
Here is how the Discord developer documentation and EveryInfra search compare on what can be read and what an object is.
| Compared | Discord Developer Documentation | EveryInfra |
|---|---|---|
| Message content | "Instead, access to MESSAGE_CONTENT permits your app to receive message content data across the APIs." | keyword matches servers in the public server directory. It does not search chat messages in servers and gives no access to private servers. |
| What a server is | "Guilds in Discord represent an isolated collection of users and channels, and are often referred to as “servers” in the UI." | Each row is one public server: name, text, member_count, online_count, categories and keywords. url is the invite link. |
The quotes come from the Gateway and Guild pages of the Discord developer documentation, checked on 2026-11-22. The pages show no update date. The Gateway page explains how an app receives events from servers through intents. The Guild page describes the server object. Official sources: Gateway · Guild Resource
Limits and gotchas
keywordis required. It searches the public server directory, not chat messages, and gives no access to private servers.limitgoes up to 100.member_countandonline_countare counts as seen at the time of the read.- A value in
vanity_url_codemeans the server has reached a Boost level threshold. - The platform sets
language, so it can be wrong. urlis the invite link anddirectory_urlis the directory page. They serve different purposes.
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": "search",
"params": {
"keyword": "game development"
}
}'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 search, 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 Search endpoint (discord/search).
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 search, and put the parameters inside params.
- Required parameters:
- keyword: Specifies search terms for public Discord server discovery in search or public user matching by username and display name in search_users. Does not index channel messages or grant access to private servers.
- Optional parameters:
- 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": "search",
"params": {
"keyword": "game development"
}
}
- 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 | search | Capability identifier, fixed value. |
keyword | body.params | string | Yes | - | Specifies search terms for public Discord server discovery in search or public user matching by username and display name in search_users. Does not index channel messages or grant access to private servers. |
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": "search", "results": [ { "id": "•••", "name": "Krunker Bunker", "url": "https://discord.gg/krunker", "text": "The official Krunker.io Discord server! Your hub for game development, trading, giveaways, and chatting!", "member_count": 192954, "online_count": 6754, "boost_count": 21, "language": "en-US", "categories": [ "LFG" ], "keywords": [ "Game", "Gaming", "Krunker" ], "icon_url": "https://cdn.discordapp.com/icons/448194623580667916/307504ce3821a7b6ffd605b21dc996a8.png?size=256.webp?size=256", "banner_url": "https://cdn.discordapp.com/banners/448194623580667916/b77e42c8e9069afa2fbdcee16a23adfc.webp?size=480", "verification_level": "COMMUNITY, DISCOVERABLE, VERIFIED", "directory_url": "https://discord.com/servers/krunker-bunker-448194623580667916", "platform": "discord" }, { "id": "•••", "name": "InfinitySports", "url": "https://discord.gg/infinitysports", "text": "Official discord server for the ROBLOX game development studio InfinitySports", "member_count": 156670, "online_count": 17822, "boost_count": 102, "language": "en-US", "categories": [ "Esports" ], "keywords": [ "basketball", "football", "hockey" ], "icon_url": "https://cdn.discordapp.com/icons/1102970117853282374/ddccd7682a0870316aa7c477b00fb259.png?size=256.webp?size=256", "banner_url": "https://cdn.discordapp.com/banners/1102970117853282374/d42d8db7fa0b142d5c23c3f0ff56eb2a.webp?size=480", "verification_level": "COMMUNITY, DISCOVERABLE", "directory_url": "https://discord.com/servers/infinitysports-1102970117853282374", "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 Discover: Discovering Community Servers ↗
Discord official documentation defines Discover Servers as discoverable Community Servers that can be browsed by category. This explains server, category, and discovery concepts, but does not represent client experiment states or complete directory coverage as an API guarantee.
Checked 2026-09-04
FAQ
What fields does the Discord search 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 one search cost?
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.
What is the difference between categories and keywords?
categories are the categories of the server, and keywords are keyword tags. To browse by category only, use directory.
Related Discord endpoints
You can call the other Discord endpoints with the same EveryInfra API key.
- Directory
directory$1.39 per 1,000 callsBrowse Discord's server directory, with an optional category. - 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.