万有引擎
搜索⌘K
中文
登录免费开始

社交内容 · 数据 API

Discord

Discord API

从 Discord 公开目录发现服务器，解析邀请对应的社区与频道，并搜索公开账号线索；不读取私信、聊天记录或私有服务器成员名单。 调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始 看文档

4

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Discord 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeyword—默认 20 · 最多 100同步$1.39 / 千次id · name · url · text · member_count · online_count · boost_count · vanity_url_code · language · categories · keywords · icon_url · banner_url · verification_level · is_nsfw · created_at · directory_url · platform
directory—category默认 20 · 最多 100同步$1.39 / 千次id · name · url · text · member_count · online_count · boost_count · vanity_url_code · language · categories · keywords · icon_url · banner_url · verification_level · is_nsfw · created_at · directory_url · platform
serverinvitecode, url—同步$1.39 / 千次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
search_userskeyword—默认 20 · 最多 100同步$1.39 / 千次id · username · name · avatar · clan_tag · server_count · invite_count · created_at · platform

Discord 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用 Discord 目录与社区发现 API？

directory

使用 platform="discord"、action="directory" 调用“目录与社区发现”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、name、url、text、member_count、online_count 等 18 个字段。

Discord directory 的参数分别是什么意思？

category可选
directory 的服务器分类：gaming 游戏、entertainment 娱乐、education 教育、music 音乐、science-and-tech 科学技术。不传则不限定分类；当前未识别的分类会被忽略，不保证按任意标签筛选。

官方举出 gaming、music、entertainment 等社区分类。EveryInfra 接受哪些分类由本页当前契约决定，不照搬旧 Discovery 文档中的全部分类或排序功能。官方来源：Discord 的服务器分类与发现范围来源核查：

Discord 特有返回字段与含义（11）
vanity_url_code
自定义邀请短链。有它说明服务器达到过 Boost 等级门槛。
member_count
服务器总成员数。
online_count
当前在线数。在线/总数比值比总数更能反映社区活跃度。
boost_count
服务器 Boost 数（成员付费加成）。
verification_level
验证等级（进入门槛）。
is_nsfw
是否为 NSFW 服务器。
categories
服务器分类。
keywords
关键词标签。
icon_url
服务器图标。
banner_url
横幅图。
directory_url
服务器目录页链接。

怎么调用 Discord 服务器资料 API？

server

使用 platform="discord"、action="server" 调用“服务器资料”能力；返回单个对象，主要包含 id、name、url、text、member_count、online_count 等 19 个字段。

Discord server 的参数分别是什么意思？

invite必填
服务器邀请定位，可传裸邀请码、discord.gg/<code> 或 discord.com/invite/<code> 完整邀请链接。server 读取邀请对应的公开信息，不会替你加入服务器；失效邀请不能视作服务器不存在。

官方 Invite 对象区分 code、guild、channel、inviter、expires_at，并将邀请返回的人数称为近似计数。引用只解释这些对象与计数边界，不意味着本接口支持官方创建、删除邀请或目标用户管理。官方来源：Discord Invite：邀请码、服务器与频道是不同对象来源核查：

code可选
invite 的兼容输入，值为邀请链接末段的邀请码；公开请求仍需包含必填 invite。不是验证码、机器人 token 或服务器 ID。
url可选
invite 的兼容输入，用于放完整 Discord 邀请链接；公开请求仍需包含必填 invite，不接受频道消息链接作为邀请。
Discord 特有返回字段与含义（14）
vanity_url_code
自定义邀请短链。有它说明服务器达到过 Boost 等级门槛。
member_count
服务器总成员数。
online_count
当前在线数。在线/总数比值比总数更能反映社区活跃度。
boost_count
服务器 Boost 数（成员付费加成）。
verification_level
验证等级（进入门槛）。
icon_url
服务器图标。
banner_url
横幅图。
invite_code
邀请码（discord.gg/ 后面那段）。
inviter_name
邀请人昵称。
inviter_username
邀请人用户名。
expires_at
邀请链接过期时间。null = 永久有效。
nsfw_level
NSFW 分级。
channel_name
频道名。
channel_type
频道类型（文字/语音/论坛）。

怎么调用 Discord 用户搜索 API？

search_users

使用 platform="discord"、action="search_users" 调用“用户搜索”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、username、name、avatar、clan_tag、server_count 等 9 个字段。

Discord search_users 的参数分别是什么意思？

keyword必填
search 查公开服务器目录，search_users 按用户名或显示名查公开用户。它不检索服务器内消息，也不授予访问私有服务器的权限。

官方区分唯一 username、可重复变化的 display name，以及优先显示的服务器昵称。该说明帮助理解候选字段，不构成全网用户目录或成员关系查询的能力承诺。官方来源：Discord：唯一用户名不等于显示名或服务器昵称来源核查：

Discord 特有返回字段与含义（4）
invite_count
邀请链接数。
clan_tag
服务器 Clan 标签。
server_count
结果里的服务器数量。
avatar
头像。
Discord search 调用流程一次 Discord search 调用的全过程：向 POST /api/v1/social 发送 platform="discord"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、name、url、text、member_count 等字段；返回列表，单次最多 100 条，计费 $1.39 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "discord"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表idnameurltextmember_count
一次 Discord search 调用的全过程：向 POST /api/v1/social 发送 platform="discord"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、name、url、text、member_count 等字段；返回列表，单次最多 100 条，计费 $1.39 / 千次，失败与空结果不计费。

Discord 原始字段名

EveryInfra 统一字段名

左边是 Discord 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

Discord 的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 11 个字段名只在 Discord 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

  • vanity_url_code
  • directory_url
  • invite_code
  • nsfw_level
  • inviter_username
  • inviter_name
  • expires_at
  • avatar
  • clan_tag
  • server_count
  • invite_count

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
name
名称。用于账号/商品/商家类能力，指该对象本身的名字。
url
该记录在原平台上的可访问链接。
text
正文内容，已去除 HTML 标签。长文可能被截断。
member_count
服务器总成员数。
online_count
当前在线数。在线/总数比值比总数更能反映社区活跃度。
boost_count
服务器 Boost 数（成员付费加成）。
vanity_url_code
自定义邀请短链。有它说明服务器达到过 Boost 等级门槛。
language
内容语言代码（如 zh、en），由平台判定，可能不准。
categories
服务器分类。
keywords
关键词标签。
icon_url
服务器图标。
banner_url
横幅图。
verification_level
验证等级（进入门槛）。
is_nsfw
是否为 NSFW 服务器。
created_at
创建时间，格式同 posted_at。
directory_url
服务器目录页链接。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
invite_code
邀请码（discord.gg/ 后面那段）。
nsfw_level
NSFW 分级。
channel_name
频道名。
channel_type
频道类型（文字/语音/论坛）。
inviter_username
邀请人用户名。
inviter_name
邀请人昵称。
expires_at
邀请链接过期时间。null = 永久有效。
username
用户名（@handle）。
avatar
头像。
clan_tag
服务器 Clan 标签。
server_count
结果里的服务器数量。
invite_count
邀请链接数。

请求填写示例

这里搜索公开服务器目录，不是检索私密频道聊天。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

discord_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"discord","action":"search","params":{"keyword":"game development"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "name": null,
  "url": null,
  "text": null,
  "member_count": null,
  "online_count": null,
  "boost_count": null,
  "vanity_url_code": null,
  "language": null,
  "categories": null,
  "keywords": null,
  "icon_url": null,
  "banner_url": null,
  "verification_level": null,
  "is_nsfw": null,
  "created_at": null,
  "directory_url": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

按主题发现 Discord 公开服务器

search 查的是社区服务器目录，用于筛选值得进一步了解的社区，而不是搜索聊天记录。

查看 search 的 keyword 参数 →
  • keyword 可写游戏、学习或音乐主题。name / text 描述服务器，categories / keywords 是目录中的分类与标签；url 是邀请入口，directory_url 是目录页，两者用途不同。
  • member_count 与 online_count 是返回时可见的规模快照，不是独立活跃用户或留存指标。没有结果不代表该主题在 Discord 上不存在；目录没有涵盖私有、未列出或无法访问的服务器，本接口也不提供成员名单和消息。

按 Discord 社区分类浏览候选服务器

directory 用分类缩小社区发现范围，不需要先知道服务器名称或邀请链接。

查看 directory 的 category 参数 →
  • category 当前映射 gaming（游戏）、entertainment（娱乐）、education（教育）、music（音乐）、science-and-tech（科学技术）。不传时不限定分类；其他词当前会被忽略，不能将任意兴趣标签当成有效分类。
  • 返回的是服务器行，name、categories、language 与 text 用于判断社区是否匹配；不是分类树或各分类的全量统计。Discord 的发现界面曾调整，不能根据本页分类表推断所有客户端都具备同样入口。

解析 Discord 邀请对应的服务器与落地频道

server 读取一条邀请的公开信息，便于核对目标社区；解析邀请不会替用户加入服务器。

查看 server 的 invite 参数 →
  • invite 接受裸邀请码、https://discord.gg/<code> 或 https://discord.com/invite/<code>。这里的 <code> 是格式占位符，不是验证过的邀请；不要传频道消息链接、服务器 ID 或账号凭据。code / url 是兼容项，不能替代公开契约要求的 invite。
  • id / name 定位服务器，channel_name / channel_type 描述邀请进入的频道，inviter_username 是创建邀请的用户，不一定是服务器所有者。member_count / online_count 应视作可见计数快照；expires_at 缺失不能据此保证邀请永久有效，邀请失效也不代表服务器已删除。

用用户名和显示名识别 Discord 公开账号线索

search_users 返回公开用户候选，适合区分相似显示名，不等于查某个服务器的全部成员。

查看 search_users 的 keyword 参数 →
  • keyword 按用户名或显示名查询。返回的 username 对应账号用户名，name 是显示名；Discord 的显示名、服务器昵称和唯一用户名不是同一个概念，匹配后应结合 id 判断对象，不能只凭显示名认人。
  • clan_tag、server_count、invite_count 只表示该结果提供的标签或数量，不证明该用户的全部服务器关系、权限或邀请历史。这里没有个人私信、邮件、电话和私有服务器成员导出能力，也不应把公开线索用于骚扰或身份冒认。

Discord API 常见问题

Discord API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="discord"、action 和 params。以 search 为例，必填 keyword，没有可选参数。这里搜索公开服务器目录，不是检索私密频道聊天。 Discord 共 4 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Discord API 怎么收费？

$1.39 / 千次，Discord 全部 4 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 Discord 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Discord API 一次能返回多少条数据？

Discord 有 3 个列表接口，包括 search、directory、search_users。其余 1 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Discord API 返回哪些字段？

当前目录为 search 列出 id、name、url、text、member_count、online_count 等 18 个字段名。按全站当前目录统计，11 个字段名只在 Discord 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「按主题发现 Discord 公开服务器」怎样接入 Discord API？

search 查的是社区服务器目录，用于筛选值得进一步了解的社区，而不是搜索聊天记录。 keyword 可写游戏、学习或音乐主题。name / text 描述服务器，categories / keywords 是目录中的分类与标签；url 是邀请入口，directory_url 是目录页，两者用途不同。 member_count 与 online_count 是返回时可见的规模快照，不是独立活跃用户或留存指标。没有结果不代表该主题在 Discord 上不存在；目录没有涵盖私有、未列出或无法访问的服务器，本接口也不提供成员名单和消息。

「按 Discord 社区分类浏览候选服务器」怎样接入 Discord API？

directory 用分类缩小社区发现范围，不需要先知道服务器名称或邀请链接。 category 当前映射 gaming（游戏）、entertainment（娱乐）、education（教育）、music（音乐）、science-and-tech（科学技术）。不传时不限定分类；其他词当前会被忽略，不能将任意兴趣标签当成有效分类。 返回的是服务器行，name、categories、language 与 text 用于判断社区是否匹配；不是分类树或各分类的全量统计。Discord 的发现界面曾调整，不能根据本页分类表推断所有客户端都具备同样入口。

「解析 Discord 邀请对应的服务器与落地频道」怎样接入 Discord API？

server 读取一条邀请的公开信息，便于核对目标社区；解析邀请不会替用户加入服务器。 invite 接受裸邀请码、https://discord.gg/<code> 或 https://discord.com/invite/<code>。这里的 <code> 是格式占位符，不是验证过的邀请；不要传频道消息链接、服务器 ID 或账号凭据。code / url 是兼容项，不能替代公开契约要求的 invite。 id / name 定位服务器，channel_name / channel_type 描述邀请进入的频道，inviter_username 是创建邀请的用户，不一定是服务器所有者。member_count / online_count 应视作可见计数快照；expires_at 缺失不能据此保证邀请永久有效，邀请失效也不代表服务器已删除。

「用用户名和显示名识别 Discord 公开账号线索」怎样接入 Discord API？

search_users 返回公开用户候选，适合区分相似显示名，不等于查某个服务器的全部成员。 keyword 按用户名或显示名查询。返回的 username 对应账号用户名，name 是显示名；Discord 的显示名、服务器昵称和唯一用户名不是同一个概念，匹配后应结合 id 判断对象，不能只凭显示名认人。 clan_tag、server_count、invite_count 只表示该结果提供的标签或数量，不证明该用户的全部服务器关系、权限或邀请历史。这里没有个人私信、邮件、电话和私有服务器成员导出能力，也不应把公开线索用于骚扰或身份冒认。

可以先免费试用 Discord API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 Discord 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 4 个能力。无需信用卡。

更多社交内容 API

Behance APIB站 APIBluesky APIDailymotion APIDeviantArt API豆瓣 API抖音 APIDribbble API全部 89 平台 ↗

开始调用 Discord API

加微信领 $1 免费额度，先选一个 Discord 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始