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 Use Discord | 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 Discord assigns directory entries to its | 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 | 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 Call | 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?
Use Discord search to discover Discord public results. For Discord search, supply keyword; results include language, member_count, name, verification_level, url, keywords, boost_count, vanity_url_code, banner_url, categories, directory_url, icon_url, id, platform, online_count, created_at, is_nsfw, and text.
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?
Discord assigns directory entries to its directory view. In this contract, the catalog declares no required selector. Pass category to Discord directory; returned objects expose platform, text, id, online_count, vanity_url_code, url, icon_url, created_at, language, verification_level, name, banner_url, keywords, member_count, directory_url, boost_count, categories, and is_nsfw.
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 server with an invite to retrieve public details for one Discord server. Account labels are Discord signals, not independent EveryInfra verification. Pass url, code, and invite to Discord server; returned objects expose id, banner_url, vanity_url_code, nsfw_level, channel_type, expires_at, invite_code, verification_level, platform, name, inviter_name, inviter_username, boost_count, text, url, icon_url, channel_name, online_count, and member_count.
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?
Call search_users to work with user candidates from Discord. Use Discord search_users with keyword for Discord user candidates. Call Discord search_users with keyword; Discord search_users exposes id, clan_tag, invite_count, username, platform, avatar, created_at, server_count, and name.
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.