Discord API

Find public Discord servers, community channels, and user clues by directory keyword or invite.

Passing an invite code or URL inspects public server metadata without joining the community.

Platform availability

24h health
Normal
Normal

Last 30 days

Available capabilities

Each Discord action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.

CapabilityWhat it doesPer 1,00024-hour health
SearchsearchFind Discord servers matching a keyword, with description, member and online counts, Boost count, language, categories, verification level and NSFW flag.$1.39 per 1,000 requestsNormal
DirectorydirectoryBrowse Discord's server directory, optionally by category, for each server's description, member and online counts, Boosts, language, tags and verification level.$1.39 per 1,000 requestsNormal
ServerserverResolve a Discord invite code or link to its server's name, description, member and online counts, Boosts, verification level, channel, inviter and expiry.$1.39 per 1,000 requestsNormal
User searchsearch_usersMatch Discord accounts by username or display name, returning ID, avatar, Clan tag, account creation date, and server and invite counts.$1.39 per 1,000 requestsNormal

Open a capability for its parameters, response fields, code samples and trial.

What does each Discord action accept?

Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.

Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.

ActionRequiredOptionalDeliveryLimitPer 1,000Response fields
search

Search

Find Discord servers matching a keyword, with description, member and online counts, Boost count, language, categories, verification level and NSFW flag. It does not search messages inside servers or open private communities.

keyword—Sync deliveryCatalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$1.39 per 1,000 requestsid · 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
directory

Directory

Browse Discord's server directory, optionally by category, for each server's 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.

categorySync deliveryCatalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$1.39 per 1,000 requestsid · 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
server

Server

Resolve a Discord invite code or link to its server's name, description, member and online counts, Boosts, verification level, channel, inviter and expiry. Reading an invite does not join the server, and a null expires_at means the invite never expires.

invitecode, urlSync delivery—$1.39 per 1,000 requestsid · name · url · text · member_count · online_count · boost_count · invite_code · vanity_url_code · icon_url · banner_url · verification_level · nsfw_level · channel_name · channel_type · inviter_username · inviter_name · expires_at · platform
search_users

User search

Match Discord accounts by username or display name, returning ID, avatar, Clan tag, account creation date, and server and invite counts. It is not a global member search and exposes no private relationships.

keyword—Sync deliveryCatalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.$1.39 per 1,000 requestsid · username · name · avatar · clan_tag · server_count · invite_count · created_at · platform

What do the Discord search parameters mean?

Find Discord servers matching a keyword, with description, member and online counts, Boost count, language, categories, verification level and NSFW flag. It does not search messages inside servers or open private communities.

Full API reference: parameters, code samples, response example and health →
keywordRequired
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.
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

What do the Discord directory parameters mean?

Browse Discord's server directory, optionally by category, for each server's 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.

Full API reference: parameters, code samples, response example and health →
categoryOptional
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.
Discord Server Categories and Discovery Scope — Discord official documentation lists community categories such as gaming, music, and entertainment. Supported categories are governed strictly by the current contract on this page and do not adopt legacy Discovery documentation categories or sorting features. · Checked

What do the Discord server parameters mean?

Resolve a Discord invite code or link to its server's name, description, member and online counts, Boosts, verification level, channel, inviter and expiry. Reading an invite does not join the server, and a null expires_at means the invite never expires.

Full API reference: parameters, code samples, response example and health →
inviteRequired
Identifies a target server using a raw invite code or full URL format (discord.gg/<code> or discord.com/invite/<code>). The server action reads public metadata attached to the invite without joining the server; expired or invalid invites do not prove a server is non-existent.
Discord Invites: Invite Codes, Servers, and Channels as Distinct Objects — Discord official Invite objects separate `code`, `guild`, `channel`, `inviter`, and `expires_at`, treating member counts returned by invites as approximate numbers. This reference clarifies object relationships and count boundaries without implying support for creating or deleting invites or managing target users. · Checked
codeOptional
Accepts the invite code segment from an invite link as a compatibility alias for the invite parameter. The request must still pass the required invite parameter; this field does not accept verification codes, bot tokens, or server IDs.
urlOptional
Provides a compatibility alias for the invite parameter that accepts a full Discord invite link. The request must still pass the required invite parameter; channel message links are not accepted as valid invites.

What do the Discord search_users parameters mean?

Match Discord accounts by username or display name, returning ID, avatar, Clan tag, account creation date, and server and invite counts. It is not a global member search and exposes no private relationships.

Full API reference: parameters, code samples, response example and health →
keywordRequired
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.
Discord: Unique Usernames vs. Display Names and Server Nicknames — Discord official sources distinguish unique usernames from editable display names and prioritized server nicknames. This distinction clarifies returned candidate fields, but does not represent a global user directory or membership lookup capability. · Checked

How to use the Discord API

  1. 01Read the public catalog and choose a platform action.
  2. 02Send the platform, action, and required parameters to POST /api/v1/social.
  3. 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
  4. 04Store the structured response fields needed by your application.
discord_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"discord","action":"search","params":{"keyword":"<keyword>"}}'

Discord API questions

What can I retrieve with the Discord API?

Set platform to discord. The current catalog lists search, directory, server, and user search. These action names identify different Discord objects or views; they are not interchangeable search modes.

Which input starts a Discord `search` request?

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. Send it as keyword inside params.

Which fields can Discord `search` return?

Its declared schema includes name, text, member_count, and online_count. A declared field can still be absent from an individual record, and every other action has its own field list.

Does every Discord action return immediately?

Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.