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.

  • invite takes an invite code, discord.gg/<code> or discord.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
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "discord",
      "action": "server",
      "params": {
        "invite": "discord.gg/limewire"
      }
    }
  2. 2JSON response

    {
      "results": {
        "name": "LimeWire",
        "text": "The new LimeWire",
        "member_count": 1957101,
        "online_count": 28267,
        …
      }
    }
  3. 3Fields

    nametextmember_countonline_count
    LimeWireThe new LimeWire195710128267
  4. 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

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

idnameurltextmember_countonline_countboost_countinvite_codevanity_url_codeicon_urlbanner_urlverification_levelnsfw_levelchannel_namechannel_typeinviter_usernameinviter_nameexpires_atplatform
LimeWirehttps://discord.gg/limewireThe new LimeWire1957101282678limewirelimewirehttps://cdn.discordapp.com/icons/1046979304547954728/bbe5d6097255431300cfc18dd629b876.pnghttps://cdn.discordapp.com/banners/1046979304547954728/d16ea54ee56246388b498ee9256de5ed.pngLOWDEFAULT📢︱updatesANNOUNCEMENTnullnullnulldiscord

Use cases

  • Check which community an invite points to

    Read name, text, invite_code and vanity_url_code to confirm the server behind an invite.

  • See which channel an invite lands in

    Read channel_name and channel_type to see which channel the invite brings people to.

  • See who sent the invite

    Read inviter_username and inviter_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.

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

  • invite is required: an invite code, discord.gg/<code> or discord.com/invite/<code>. A link to a channel message, a server ID or an account password is not accepted.
  • code and url are alternative inputs. The request still needs invite.
  • It reads the public details of the invite and does not join the server for you.
  • inviter_username is the user who made the invite, not always the owner of the server.
  • member_count and online_count are 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.

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

POST

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

#
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.
actionbodystringYesserverCapability identifier, fixed value.
invitebody.paramsstringYes-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.
codebody.paramsstringNo-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.
urlbody.paramsstringNo-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

#
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. id, billing and quota differ on every call, so only their shape is shown.
json
{  "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.

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
invite_codeKeeps the platform's own meaning
vanity_url_codeKeeps 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
nsfw_levelKeeps the platform's own meaning
channel_nameKeeps the platform's own meaning
channel_typeKeeps the platform's own meaning
inviter_usernameKeeps the platform's own meaning
inviter_nameKeeps the platform's own meaning
expires_atKeeps 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 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.

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

Google Analytics needs consent. Privacy