Discord Server API
Read the public details of the server behind a Discord invite by invite: name, member_count, online_count, channel_name, channel_type and inviter_username, for $1.39 per 1,000 calls.
invitetakes an invite code,discord.gg/<code>ordiscord.com/invite/<code>.- It reads only the public details of the invite and does not join the server.
- 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": "server", "params": { "invite": "discord.gg/limewire" } }2JSON response
{ "results": { "name": "LimeWire", "text": "The new LimeWire", "member_count": 1957101, "online_count": 28267, … } }3Fields
name text member_count online_count LimeWire The new LimeWire 1957101 28267 4CSV
discord-server-sample.csv 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
invite goes in, and one JSON object comes back with fields such as name, member_count and channel_name, listed as a field table and a CSV file.What data you get
The table shows a real call for discord.gg/limewire, captured September 26, 2026 at 08:56 (UTC), that returned one object; 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 | invite_code | vanity_url_code | icon_url | banner_url | verification_level | nsfw_level | channel_name | channel_type | inviter_username | inviter_name | expires_at | platform |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| LimeWire | https://discord.gg/limewire | The new LimeWire | 1957101 | 28267 | 8 | limewire | limewire | https://cdn.discordapp.com/icons/1046979304547954728/bbe5d6097255431300cfc18dd629b876.png | https://cdn.discordapp.com/banners/1046979304547954728/d16ea54ee56246388b498ee9256de5ed.png | LOW | DEFAULT | 📢︱updates | ANNOUNCEMENT | null | null | null | discord |
Use cases
Check which community an invite points to
Read
name,text,invite_codeandvanity_url_codeto confirm the server behind an invite.See which channel an invite lands in
Read
channel_nameandchannel_typeto see which channel the invite brings people to.See who sent the invite
Read
inviter_usernameandinviter_name. The inviter is the user who made the invite, not always the owner of the server.Check how long an invite lasts
Read
expires_at. When this field is absent, do not assume that the invite never expires.
Discord Developer Documentation vs EveryInfra
Here is how the Discord developer documentation and EveryInfra server compare on the invite object, reading by invite code and member counts.
| Compared | Discord Developer Documentation | EveryInfra |
|---|---|---|
| What an invite is | "Represents a code that when used, adds a user to a guild or group DM channel." | invite takes an invite code, discord.gg/<code> or discord.com/invite/<code>. server reads only the public details of the invite and does not join the server for you. |
| Reading by invite code | "Returns an invite object for the given code." | One object comes back: id, name, channel_name, channel_type, inviter_username, expires_at and more. |
| Member counts | "approximate count of total members, returned from the GET /invites/<code> endpoint when with_counts is true" | member_count and online_count are counts as seen at the time of the read. |
The quotes come from the Invite page of the Discord developer documentation, checked on 2026-11-22. The page shows no update date. Official sources: Invite Resource
Limits and gotchas
inviteis required: an invite code,discord.gg/<code>ordiscord.com/invite/<code>. A link to a channel message, a server ID or an account password is not accepted.codeandurlare alternative inputs. The request still needsinvite.- It reads the public details of the invite and does not join the server for you.
inviter_usernameis the user who made the invite, not always the owner of the server.member_countandonline_countare counts as seen at the time of the read.- One call reads one invite and returns one object.
Pricing
You pay $0.001389 per call, and one call reads one invite. 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": "server",
"params": {
"invite": "discord.gg/limewire"
}
}'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 server, 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 Server endpoint (discord/server).
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 server, and put the parameters inside params.
- Required parameters:
- invite: 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.
- Optional parameters:
- code: 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.
- url: 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.
- Returns one object. Main fields: id, name, url, text, member_count, online_count, boost_count, invite_code, vanity_url_code, icon_url, banner_url, verification_level; 18 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=discord.
- Example request body:
{
"platform": "discord",
"action": "server",
"params": {
"invite": "discord.gg/limewire"
}
}
- 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 | server | Capability identifier, fixed value. |
invite | body.params | string | Yes | - | 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. |
code | body.params | string | No | - | 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. |
url | body.params | string | No | - | 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. |
Response example
#{ "id": "req_…", "platform": "discord", "action": "server", "results": { "id": "•••", "name": "LimeWire", "url": "https://discord.gg/limewire", "text": "The new LimeWire", "member_count": 1957101, "online_count": 28267, "boost_count": 8, "invite_code": "limewire", "vanity_url_code": "limewire", "icon_url": "https://cdn.discordapp.com/icons/1046979304547954728/bbe5d6097255431300cfc18dd629b876.png", "banner_url": "https://cdn.discordapp.com/banners/1046979304547954728/d16ea54ee56246388b498ee9256de5ed.png", "verification_level": "LOW", "nsfw_level": "DEFAULT", "channel_name": "📢︱updates", "channel_type": "ANNOUNCEMENT", "platform": "discord" }, "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 |
invite_code | Keeps the platform's own meaning |
vanity_url_code | 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 |
nsfw_level | Keeps the platform's own meaning |
channel_name | Keeps the platform's own meaning |
channel_type | Keeps the platform's own meaning |
inviter_username | Keeps the platform's own meaning |
inviter_name | Keeps the platform's own meaning |
expires_at | 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 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 2026-09-04
FAQ
What fields does the server details API return?
One object with 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 and expires_at.
How much does it cost to read one invite?
It costs $0.001389 per call, or $1.39 per 1,000 calls. Failed calls and empty results are not charged.
What is the difference between invite_code and vanity_url_code?
invite_code is the invite code, the part after discord.gg/. vanity_url_code is the custom invite short link. A server that has one has reached a Boost level threshold.
Related Discord endpoints
You can call the other Discord endpoints with the same EveryInfra API key.
- Search
search$1.39 per 1,000 callsFind Discord servers that match a keyword. - Directory
directory$1.39 per 1,000 callsBrowse Discord's server directory, with an optional category. - 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.