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.

  • username es el nombre de usuario único y name es el nombre visible.
  • limit llega 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
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

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

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

    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

Entra una solicitud con 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.

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

Casos de uso

  • Distinguir nombres visibles parecidos

    Cuando dos cuentas tienen un name parecido, usa id y username para ver si son la misma cuenta.

  • Leer la etiqueta de servidor que muestra un usuario

    Lee clan_tag para ver la etiqueta de servidor que muestra el usuario.

  • Ver la escala de una pista pública

    Lee server_count e invite_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.

AspectoDocumentación para desarrolladores y Centro de ayuda de DiscordEveryInfra
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

  • keyword es obligatorio. Busca usuarios públicos por nombre de usuario o nombre visible.
  • limit llega hasta 100.
  • Un nombre visible, un apodo de servidor y el nombre de usuario único son cosas distintas. Tras una coincidencia, usa id para decidir de qué cuenta se trata, y no identifiques a una persona solo por el nombre visible.
  • clan_tag, server_count e invite_count muestran 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.

LlamadasCosto
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

#
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"
  }
}'

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.

POST

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

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-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.
platformbodystringSídiscordIdentificador de la plataforma, valor fijo.
actionbodystringSísearch_usersIdentificador de la capacidad, valor fijo.
keywordbody.paramsstringSí-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.
limitbody.paramsinteger (1–100)No20Nú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

#
Obtenida el 26 de septiembre de 2026, 08:56 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto); la lista conserva los primeros 2. id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
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": { … }}

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.

CampoSignificado
idIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
usernameNombre de usuario (@usuario).
nameNombre del propio objeto, en capacidades de cuentas, productos y negocios.
avatarConserva el significado de la plataforma
clan_tagConserva el significado de la plataforma
server_countConserva el significado de la plataforma
invite_countConserva el significado de la plataforma
created_atFecha de creación, con el mismo formato que posted_at.
platformIdentificador 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.

Errores

Referencias oficiales

#

Solo sirven para contrastar objetos y términos. No implican autorización ni respaldo de la plataforma a EveryInfra.

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.

Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de Discord.

Google Analytics solo si aceptas. Privacidad