API de Búsqueda de usuarios de Discord
Busca usuarios públicos de Discord por keyword, comparada con el nombre de usuario o el nombre visible. Cada fila trae id, username, name, clan_tag, server_count e invite_count, por $1.39 por cada 1000 llamadas.
usernamees el nombre de usuario único ynamees el nombre visible.limitllega hasta 100.- Las llamadas fallidas y los resultados vacíos no se cobran.
Salud de la API
- Salud 24 h
- Normal
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
1Solicitud
POST /api/v1/social { "platform": "discord", "action": "search_users", "params": { "keyword": "leo" } }2Respuesta JSON
{ "results": [ { "username": "", "clan_tag": "Ca㏌e", "server_count": 65, "invite_count": 65 }, … ], "count": 20 }3Filas
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 y salen los usuarios públicos que coinciden; cada fila de results es un usuario, y se muestra como tabla de campos y se puede descargar en CSV.Qué datos obtienes
La tabla muestra una llamada real para leo, obtenida el 26 de septiembre de 2026, 08:56 (UTC), que devolvió 20 filas; las barras grises marcan datos personales eliminados (••• en el CSV). En tus llamadas recibes estos campos, tal como figuran en la referencia de campos.
| 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 |
Casos de uso
Distinguir nombres visibles parecidos
Cuando dos cuentas tienen un
nameparecido, usaidyusernamepara ver si son la misma cuenta.Leer la etiqueta de servidor que muestra un usuario
Lee
clan_tagpara ver la etiqueta de servidor que muestra el usuario.Ver la escala de una pista pública
Lee
server_counteinvite_count. Son las cifras que da este resultado, no todos los vínculos del usuario con servidores.
Documentación para desarrolladores y Centro de ayuda de Discord frente a EveryInfra
Así se comparan la documentación de Discord y search_users de EveryInfra en cómo se encuentra a las personas, los nombres de usuario, los nombres visibles y el alcance de la búsqueda.
| Aspecto | Documentación para desarrolladores y Centro de ayuda de Discord | EveryInfra |
|---|---|---|
| Cómo se encuentra a una persona | "Returns a user object for a given user ID." | keyword busca usuarios públicos por nombre de usuario o nombre visible, así que no necesitas el ID del usuario de antemano. Cada fila trae id. |
| Nombre de usuario | "Usernames are unique to each user and no two users can share the same username" | username es el nombre de usuario único de la cuenta, y id te dice de qué cuenta se trata. |
| Nombre visible | "Display names are not unique to each user and can be set to whatever you want, whenever you want" | name es el nombre visible. No siempre es único, así que no identifiques a una persona solo por él. |
| Alcance de la búsqueda | "Returns a list of guild member objects whose username or nickname starts with a provided string." | El resultado es una lista de usuarios públicos, no la lista de miembros de un servidor. |
Las citas salen de las páginas User y Guild de la documentación para desarrolladores de Discord y del artículo sobre nombres de usuario del Centro de ayuda, y se cotejaron el 2026-11-22. Las páginas no muestran fecha de actualización. Fuentes oficiales: User Resource · Guild Resource · New Usernames & Display Names
Límites y detalles a tener en cuenta
keywordes obligatorio. Busca usuarios públicos por nombre de usuario o nombre visible.limitllega hasta 100.- Un nombre visible, un apodo de servidor y el nombre de usuario único son cosas distintas. Tras una coincidencia, usa
idpara decidir de qué cuenta se trata, y no identifiques a una persona solo por el nombre visible. clan_tag,server_counteinvite_countmuestran solo la etiqueta o la cifra que da este resultado. No muestran todos los vínculos del usuario con servidores.- No lee mensajes directos ni mensajes dentro de servidores, y no da la lista de miembros de un servidor privado.
Precios
Pagas $0.001389 por llamada, no por fila. Las llamadas fallidas y los resultados vacíos no se cobran.
| Llamadas | Costo |
|---|---|
| 10,000 | $13.89 |
| 100,000 | $138.89 |
| 1,000,000 | $1,388.89 |
Los totales se calculan con el precio de lista por llamada.
Ejemplos de código
#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"
}
}'Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.
Referencia de API
Consulta los parámetros, los campos de respuesta, los errores y la facturación de search_users, y copia la página o ábrela en Markdown para dársela a un asistente de IA.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Discord: Búsqueda de usuarios (discord/search_users).
Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en discord y action en search_users, y los parámetros dentro de params.
- Parámetros obligatorios:
- keyword: Usa search para buscar en el directorio de servidores públicos o search_users para buscar usuarios por su nombre de usuario o nombre público.
- Parámetros opcionales:
- limit: Número máximo de filas que devuelve esta llamada, un entero de 1 a 100. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. (por defecto: 20)
- Devuelve una lista de registros. Campos principales de cada registro: id, username, name, avatar, clan_tag, server_count, invite_count, created_at.
- Cuerpo de solicitud de ejemplo:
{
"platform": "discord",
"action": "search_users",
"params": {
"keyword": "leo"
}
}
- Precio: $1.39 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.
Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.Parámetros de la solicitud
#| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código. |
platform | body | string | Sí | discord | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | search_users | Identificador de la capacidad, valor fijo. |
keyword | body.params | string | Sí | - | Usa search para buscar en el directorio de servidores públicos o search_users para buscar usuarios por su nombre de usuario o nombre público. Esta acción no recupera mensajes de los servidores ni da acceso a servidores privados. |
limit | body.params | integer (1–100) | No | 20 | Número máximo de filas que devuelve esta llamada, un entero de 1 a 100. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. Los valores mayores devuelven 422 antes de cualquier cobro. |
Ejemplo de respuesta
#{ "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": { … }}
Campos de la respuesta
#Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.
| Campo | Significado |
|---|---|
id | Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas. |
username | Nombre de usuario (@usuario). |
name | Nombre del propio objeto, en capacidades de cuentas, productos y negocios. |
avatar | Conserva el significado de la plataforma |
clan_tag | Conserva el significado de la plataforma |
server_count | Conserva el significado de la plataforma |
invite_count | Conserva el significado de la plataforma |
created_at | Fecha de creación, con el mismo formato que posted_at. |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Errores y facturación
#- 401
- Falta la clave o no es válida.
- 402
- Saldo insuficiente. Recarga primero.
- 422
- Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
- 429
- Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
- 503
- No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
- 200 vacío
- Sin datos. Sin cargo.
Referencias oficiales
#Solo sirven para contrastar objetos y términos. No implican autorización ni respaldo de la plataforma a EveryInfra.
- Discord: el nombre de usuario único no es lo mismo que el nombre de visualización o el apodo del servidor ↗
La documentación oficial distingue entre el `username` (único), el `display name` (variable y no único) y el apodo del servidor (que se muestra con prioridad). Esta aclaración ayuda a interpretar los campos de los resultados, pero no constituye una promesa de acceso a un directorio de todos los usuarios de la plataforma ni a la consulta de relaciones entre miembros.
Comprobado el 2026-09-04
Preguntas frecuentes
¿Qué campos devuelve la API de búsqueda de usuarios?
Cada fila trae id, username, name, avatar, clan_tag, server_count, invite_count y created_at.
¿Cuánto cuesta una búsqueda?
Cuesta $0.001389 por llamada, o $1.39 por cada 1000 llamadas, y se factura por llamada, no por fila. Las llamadas fallidas y los resultados vacíos no se cobran.
¿Puedo ver en qué servidores está un usuario?
No. server_count e invite_count son solo cifras que da el resultado. No listan los servidores y no cubren todos los vínculos del usuario con servidores.
Capacidades de Discord relacionadas
Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de Discord.
- Búsqueda
search$1.39 por cada 1000 llamadasBusca servidores públicos de Discord mediantekeyword, devolviendo nombre, descripción, miembros, usuarios en línea y categorías observadas. - Directorio y comunidades
directory$1.39 por cada 1000 llamadasExplora el directorio público y puede acotarlo concategory, sin texto obligatorio. - Datos del servidor
server$1.39 por cada 1000 llamadasCon esta API de Discord pasas eninviteun enlace o código de invitación y recibes la ficha pública del servidor: nombre, descripción, miembros, conectados y mejoras.