Discord User search API

Search public Discord users by keyword, matched against username or display name. Each row has id, username, name, clan_tag, server_count and invite_count, for $1.39 per 1,000 calls.

Discord User search looks up public Discord accounts whose username or display name matches a keyword, such as leo. Each row carries the account's id, its username, the display name in name, the avatar, the server Clan tag in clan_tag, the account's creation time in created_at, and the number of servers and invite links in the result as server_count and invite_count. It answers which public accounts go by a given name.

Brand and community teams use it to find accounts that borrow an official name and to confirm that a handle they publish points to the intended account. Treat the rows as candidates: one term can match several accounts with the same or similar names, so key stored records on id rather than on either name. The search covers public account records only; it does not read messages inside servers and does not open private servers.

  • username is the unique username and name is the display name.
  • limit goes up to 100.
  • 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": "search_users",
      "params": {
        "keyword": "leo"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "username": "",
          "clan_tag": "Ca㏌e",
          "server_count": 65,
          "invite_count": 65
        },
        …
      ],
      "count": 20
    }
  3. 3Rows

    usernameclan_tagserver_countinvite_count
    Ca㏌e6565
    undefined2542
  4. 4CSV

    discord-search_users-sample.csv id,username,name,avatar,clan_tag,server_count,invite_count,created_at,platform

A request with keyword goes in, and the matching public users come back; each row in results is one user, listed as a field table and a CSV file.

What data you get

The table shows a real call for leo, captured September 26, 2026 at 08:56 (UTC), that returned 20 rows; gray bars mark removed personal information (••• in the CSV). Your own calls return these fields as listed in the field reference.

idusernamenameavatarclan_tagserver_countinvite_countcreated_atplatform
Ca㏌e65652025-05-14T00:00:00+00:00discord
null25422018-02-16T00:00:00+00:00discord

Use cases

  • Tell look-alike display names apart

    When two accounts have a similar name, use id and username to see if they are the same account.

  • Read the server tag a user shows

    Read clan_tag to see the server tag that the user displays.

  • See the scale of a public lead

    Read server_count and invite_count. They are the numbers this result provides, not all the server links of the user.

Discord Developer Documentation and Help Center vs EveryInfra

Here is how the Discord documentation and EveryInfra search_users compare on how people are found, usernames, display names and the search scope.

ComparedDiscord Developer Documentation and Help CenterEveryInfra
How people are found"Returns a user object for a given user ID."keyword looks up public users by username or display name, so you do not need the user ID first. Each row has id.
Username"Usernames are unique to each user and no two users can share the same username"username is the unique username of the account, and id tells you which account it is.
Display name"Display names are not unique to each user and can be set to whatever you want, whenever you want"name is the display name. It is not always unique, so do not identify a person by it alone.
Search scope"Returns a list of guild member objects whose username or nickname starts with a provided string."The result is a list of public users, not the member list of one server.

The quotes come from the User and Guild pages of the Discord developer documentation and from the username article of the Help Center, checked on 2026-11-22. The pages show no update date. Official sources: User Resource · Guild Resource · New Usernames & Display Names

Limits and gotchas

  • keyword is required. It looks up public users by username or display name.
  • limit goes up to 100.
  • A display name, a server nickname and the unique username are different things. After a match, use id to decide which account it is, and do not identify a person by display name alone.
  • clan_tag, server_count and invite_count show only the tag or number that this result provides. They do not show all server links of the user.
  • It does not read direct messages or messages in servers, and it gives no member list of a private server.

Pricing

You pay $0.001389 per call, not per row. 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": "search_users",
  "params": {
    "keyword": "leo"
  }
}'

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 search_users, 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 User search endpoint (discord/search_users).

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 search_users, and put the parameters inside params.
- Required parameters:
  - keyword: 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.
- Optional parameters:
  - limit: The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. (default: 20)
- Returns a list of records. Main fields of each record: id, username, name, avatar, clan_tag, server_count, invite_count, created_at.
- Example request body:
{
  "platform": "discord",
  "action": "search_users",
  "params": {
    "keyword": "leo"
  }
}
- 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.
actionbodystringYessearch_usersCapability identifier, fixed value.
keywordbody.paramsstringYes-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.
limitbody.paramsinteger (1–100)No20The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge.

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; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
json
{  "id": "req_…",  "platform": "discord",  "action": "search_users",  "results": [    {      "id": "•••",      "username": "•••",      "name": "•••",      "avatar": "https://cdn.discordapp.com/•••",      "clan_tag": "Ca㏌e",      "server_count": 65,      "invite_count": 65,      "created_at": "2025-05-14T00:00:00+00:00",      "platform": "discord"    },    {      "id": "•••",      "username": "•••",      "name": "•••",      "avatar": "https://cdn.discordapp.com/•••",      "server_count": 25,      "invite_count": 42,      "created_at": "2018-02-16T00:00:00+00:00",      "platform": "discord"    }  ],  "count": 20,  "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.
usernameUsername (@handle).
nameName of the object itself, for account, product and business capabilities.
avatarKeeps the platform's own meaning
clan_tagKeeps the platform's own meaning
server_countKeeps the platform's own meaning
invite_countKeeps the platform's own meaning
created_atCreation time, same format as posted_at.
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.

FAQ

Can I look up a Discord user by username?

Yes. Pass the username as keyword. Discord User search matches usernames and display names alike, so several accounts can come back instead of one exact hit. Compare the username on each row with the handle you expected before you rely on a match, and remember that only public account records are searched.

Does Discord User search read messages or private servers?

No. It reads public account records and nothing else: it does not search messages inside servers and does not grant access to private servers. To find public servers rather than people, use the Discord Search capability, which searches the public server directory by keyword, or browse that directory by category with Discord Directory.

How do I tell look-alike accounts apart?

Key them on id, the account's unique ID on Discord, because a name alone can match several accounts. Then compare username, the account's handle, and created_at, its creation time in ISO 8601, to tell an established account from a newer one with a similar name.

What fields does the user search API return?

Each row has id, username, name, avatar, clan_tag, server_count, invite_count and created_at.

How much does one search cost?

It costs $0.001389 per call, or $1.39 per 1,000 calls, billed per call and not per row. Failed calls and empty results are not charged.

Can I see which servers a user is in?

No. server_count and invite_count are only numbers that the result provides. They do not list the servers, and they do not cover all server links of the user.

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

Google Analytics needs consent. Privacy