Discord 用户搜索 API

按 keyword 搜 Discord 公开用户,匹配用户名或显示名,每行返回 id、username、name、clan_tag、server_count 和 invite_count,每千次 $1.39。

  • username 是唯一用户名,name 是显示名
  • limit 最大 100
  • 失败和空结果不收费
免费开始

接口健康状态

24h 健康值
正常
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
正常

24 小时趋势

30 天趋势

  1. 1请求

    POST /api/v1/social
    {
      "platform": "discord",
      "action": "search_users",
      "params": {
        "keyword": "leo"
      }
    }
  2. 2JSON 响应

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

    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

请求带 keyword,返回匹配的公开用户,results 里每行是一个用户,列成字段表,也可下载为 CSV。

能拿到什么数据

下表取自对 leo 的一次真实调用,采集于 2026年9月26日 16:56(UTC),共返回 20 行;灰条是隐去的个人信息(CSV 里是 •••)。你自己调用时,按字段表返回这些字段。

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

用途

  • 分清相似的显示名

    两个账号的 name 很像时,用 id 和 username 判断是不是同一个账号。

  • 读用户带的服务器标签

    读 clan_tag,看这个用户展示的服务器标签。

  • 看公开线索的规模

    读 server_count 和 invite_count,这是这条结果提供的数量,不代表该用户全部的服务器关系。

Discord 开发者文档和帮助中心 与 EveryInfra 对比

下面从找人的方式、用户名和显示名、搜索范围三方面,比较 Discord 官方文档和 EveryInfra search_users。

对比项Discord 开发者文档和帮助中心EveryInfra
找人的方式"Returns a user object for a given user ID."keyword 按用户名或显示名查公开用户,不用先知道用户 ID;每行带 id。
用户名"Usernames are unique to each user and no two users can share the same username"username 对应账号的唯一用户名,id 用来确认是哪个账号。
显示名"Display names are not unique to each user and can be set to whatever you want, whenever you want"name 是显示名,不一定唯一,不能只凭它认人。
搜索范围"Returns a list of guild member objects whose username or nickname starts with a provided string."结果是公开用户,不是某个服务器的成员列表。

引文出自 Discord 开发者文档的 User 页、Guild 页和帮助中心的用户名说明,原文是英文,2026-11-22 核对;页面没有标更新日期。 官方出处: User Resource · Guild Resource · New Usernames & Display Names

限制和注意事项

  • keyword 必填,按用户名或显示名查公开用户。
  • limit 最大 100。
  • 显示名、服务器昵称和唯一用户名不是同一个概念,匹配后要按 id 判断对象,不能只凭显示名认人。
  • clan_tag、server_count、invite_count 只表示这条结果提供的标签或数量,不代表该用户的全部服务器关系。
  • 不读私信,不读服务器里的消息,也不提供私有服务器的成员名单。

价格

每次调用 $0.001389,按次计费,不按条数算。失败和空结果不收费。

调用次数费用
10,000$13.89
100,000$138.89
1,000,000$1,388.89

合计按每次调用的标价算。

代码示例

#
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 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。

API 参考

下面是 search_users 的参数、响应字段、错误和计费,可以复制整页,或用 Markdown 打开后交给 AI 助手。

POST

AI 提示词

#
请帮我用 EveryInfra 的「Discord 用户搜索」接口(discord/search_users)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 discord,action 填 search_users,参数放在 params 里。
- 必填参数:
  - keyword:search 查公开服务器目录,search_users 按用户名或显示名查公开用户。它不检索服务器内消息,也不授予访问私有服务器的权限。
- 可选参数:
  - limit:这次调用最多返回的条数,整数,1–100;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。(默认 20)
- 返回一组记录,每条记录的主要字段:id、username、name、avatar(头像)、clan_tag(服务器 Clan 标签)、server_count(结果里的服务器数量)、invite_count(邀请链接数)、created_at。
- 示例请求体:
{
  "platform": "discord",
  "action": "search_users",
  "params": {
    "keyword": "leo"
  }
}
- 计费:$1.39 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。

写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。

请求参数

#
参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。
platformbodystring是discord平台标识,固定值。
actionbodystring是search_users能力标识,固定值。
keywordbody.paramsstring是-search 查公开服务器目录,search_users 按用户名或显示名查公开用户。它不检索服务器内消息,也不授予访问私有服务器的权限。
limitbody.paramsinteger (1–100)否20这次调用最多返回的条数,整数,1–100;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。

响应示例

#
2026年9月26日 16:56(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息,列表只保留前 2 条;id、billing、quota 每次调用都不同,只给结构。
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": { … }}

返回字段

#

业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。

字段含义
id该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
username用户名(@handle)。
name名称。用于账号/商品/商家类能力,指该对象本身的名字。
avatar头像。
clan_tag服务器 Clan 标签。
server_count结果里的服务器数量。
invite_count邀请链接数。
created_at创建时间,格式同 posted_at。
platform数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

错误与计费

#
401
缺少 Key 或 Key 无效。
402
余额不足,先充值。
422
参数名或取值不对,按错误信息给的候选改;不扣费。
429
超过每分钟请求上限,按 Retry-After 等待后再试。
503
暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
200 空结果
没有数据,不扣费。

错误码

常见问题

用户搜索接口返回哪些字段?

每行有 id、username、name、avatar、clan_tag、server_count、invite_count 和 created_at。

搜一次要多少钱?

每次 $0.001389,每千次 $1.39,按调用次数算,不按条数算。失败和空结果不收费。

能读到这个用户在哪些服务器里吗?

不能。server_count 和 invite_count 只是这条结果提供的数量,不列出具体服务器,也不代表该用户的全部服务器关系。

同一把 Key 还能调用 Discord 的其他能力。

Google Analytics 同意才加载 隐私