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.
usernameis the unique username andnameis the display name.limitgoes up to 100.- 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": "search_users", "params": { "keyword": "leo" } }2JSON response
{ "results": [ { "username": "", "clan_tag": "Ca㏌e", "server_count": 65, "invite_count": 65 }, … ], "count": 20 }3Rows
username clan_tag server_count invite_count Ca㏌e 65 65 undefined 25 42 4CSV
discord-search_users-sample.csv id,username,name,avatar,clan_tag,server_count,invite_count,created_at,platform
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.
| id | username | name | avatar | clan_tag | server_count | invite_count | created_at | platform |
|---|---|---|---|---|---|---|---|---|
| Ca㏌e | 65 | 65 | 2025-05-14T00:00:00+00:00 | discord | ||||
null | 25 | 42 | 2018-02-16T00:00:00+00:00 | discord |
Use cases
Tell look-alike display names apart
When two accounts have a similar
name, useidandusernameto see if they are the same account.Read the server tag a user shows
Read
clan_tagto see the server tag that the user displays.See the scale of a public lead
Read
server_countandinvite_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.
| Compared | Discord Developer Documentation and Help Center | EveryInfra |
|---|---|---|
| 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
keywordis required. It looks up public users by username or display name.limitgoes up to 100.- A display name, a server nickname and the unique username are different things. After a match, use
idto decide which account it is, and do not identify a person by display name alone. clan_tag,server_countandinvite_countshow 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.
| 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": "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.
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
#| 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 | search_users | Capability identifier, fixed value. |
keyword | body.params | string | Yes | - | 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. |
limit | body.params | integer (1–100) | No | 20 | 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. |
Response example
#{ "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.
| Field | Meaning |
|---|---|
id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
username | Username (@handle). |
name | Name of the object itself, for account, product and business capabilities. |
avatar | Keeps the platform's own meaning |
clan_tag | Keeps the platform's own meaning |
server_count | Keeps the platform's own meaning |
invite_count | Keeps the platform's own meaning |
created_at | Creation time, same format as posted_at. |
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: Unique Usernames vs. Display Names and Server Nicknames ↗
Discord 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 2026-09-04
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.
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. - Server
server$1.39 per 1,000 callsResolve a Discord invite code or link to its server's name, description, member and online counts, Boosts, verification level, channel, inviter and expiry.