EveryData platform API
Discord API
Discord data here means Discord server discovery, directory entries, invite-based server details, and user candidates, divided among 4 Discord actions with explicit Discord target objects: `search`, `directory`, `server`.
Choose `search` when the object is matching public results rather than the directory entries read by `directory`; its key selector is `keyword`, compared with no required business input.
- Endpoint
- POST /api/v1/social
- Capabilities
- 4
- Per 1,000
- $1.389
Available capabilities
Compare the Discord actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on Discord. Accepts these parameters: | keyword | — | Sync delivery | Catalog 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 requests | 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 |
directoryDirectory Retrieve entries from the public Discord directory. Accepts these parameters: | category | Sync delivery | Catalog 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 requests | 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 | |
serverServer Use the | invite | code, url | Sync delivery | — | $1.39 per 1,000 requests | id · 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_usersUser search Search Discord with the | keyword | — | Sync delivery | Catalog 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 requests | id · username · name · avatar · clan_tag · server_count · invite_count · created_at · platform |
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.
What do the Discord search parameters mean?
Search public results on Discord. Accepts these parameters: keyword. Returns these fields: language, member_count, name, and verification_level.
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 ServersDiscord 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?
Retrieve entries from the public Discord directory. Accepts these parameters: category. Returns these fields: text, online_count, vanity_url_code, and icon_url.
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 ScopeDiscord 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?
Use the server action on Discord. Accepts these parameters: url, code, and invite. Returns these fields: banner_url, vanity_url_code, nsfw_level, and channel_type.
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 ObjectsDiscord 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- Provides a compatibility alias for invite accepting the invite code segment from an invite link. 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?
Search Discord with the search_users action. Accepts these parameters: keyword. Returns these fields: clan_tag, invite_count, username, and avatar.
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 NicknamesDiscord 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
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
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 source record, and every other action has its own field list.
Does every Discord action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.