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.

  • categories and keywords are the category and keyword tags of a server.
  • limit goes up to 100.
  • Failed calls and empty results are not charged.

API health

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

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "discord",
      "action": "search",
      "params": {
        "keyword": "game development"
      }
    }
  2. 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
    }
  3. 3Rows

    nametextmember_countonline_count
    Krunker BunkerThe official Krunker.io Discord server! Your hub for game development, trading, giveaways, and chatting!1929546754
    InfinitySportsOfficial discord server for the ROBLOX game development studio InfinitySports15667017822
  4. 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

A request with 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.

idnameurltextmember_countonline_countboost_countvanity_url_codelanguagecategorieskeywordsicon_urlbanner_urlverification_levelis_nsfwcreated_atdirectory_urlplatform
Krunker Bunkerhttps://discord.gg/krunkerThe official Krunker.io Discord server! Your hub for game development, trading, giveaways, and chatting!192954675421nullen-US["LFG"]["Game","Gaming","Krunker"]https://cdn.discordapp.com/icons/448194623580667916/307504ce3821a7b6ffd605b21dc996a8.png?size=256.webp?size=256https://cdn.discordapp.com/banners/448194623580667916/b77e42c8e9069afa2fbdcee16a23adfc.webp?size=480COMMUNITY, DISCOVERABLE, VERIFIEDnullnullhttps://discord.com/servers/krunker-bunker-448194623580667916discord
InfinitySportshttps://discord.gg/infinitysportsOfficial discord server for the ROBLOX game development studio InfinitySports15667017822102nullen-US["Esports"]["basketball","football","hockey"]https://cdn.discordapp.com/icons/1102970117853282374/ddccd7682a0870316aa7c477b00fb259.png?size=256.webp?size=256https://cdn.discordapp.com/banners/1102970117853282374/d42d8db7fa0b142d5c23c3f0ff56eb2a.webp?size=480COMMUNITY, DISCOVERABLEnullnullhttps://discord.com/servers/infinitysports-1102970117853282374discord

Use cases

  • Find similar communities to compare with

    Search the topic word of your product and compare member_count and online_count to see how large similar communities are.

  • Find communities where your audience gathers

    Read text, categories and keywords to pick servers that fit your audience, then follow url to look at them.

  • Leave out adult servers first

    Read is_nsfw to drop servers with adult content, then look at what is left.

  • See communities by language

    Group by language to see in which languages a topic is active. The platform sets language, 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.

ComparedDiscord Developer DocumentationEveryInfra
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

  • keyword is required. It searches the public server directory, not chat messages, and gives no access to private servers.
  • limit goes up to 100.
  • member_count and online_count are counts as seen at the time of the read.
  • A value in vanity_url_code means the server has reached a Boost level threshold.
  • The platform sets language, so it can be wrong.
  • url is the invite link and directory_url is 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.

CallsCost
10,000$13.89
100,000$138.89
1,000,000$1,388.89

Totals use the list price per call.

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": "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.

POST

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

#
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.
actionbodystringYessearchCapability identifier, fixed value.
keywordbody.paramsstringYes-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.
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.

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": "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.

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).

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 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.

You can call the other Discord endpoints with the same EveryInfra API key.

Google Analytics needs consent. Privacy