Inicio rápido de búsqueda de usuarios

Buscar usuarios por ID o nombre de usuario

Esta guía te explica cómo buscar usuarios por su ID o nombre de usuario.

Requisitos previos

Antes de comenzar, necesitarás:

• Una cuenta de desarrollador con una App aprobada
• El Bearer Token de tu App

---

​

Buscar por id

​

Usuario individual

cURL

shellscript

curl "https://api.x.com/2/users/2244994945?\
user.fields=created_at,description,verified,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

Respuesta

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "XDevelopers",
    "created_at": "2013-12-14T04:35:55.000Z",
    "description": "The voice of the X developer community",
    "verified": true,
    "public_metrics": {
      "followers_count": 583423,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

​

Múltiples usuarios

Consulta hasta 100 usuarios a la vez:

cURL

shellscript

curl "https://api.x.com/2/users?\
ids=2244994945,783214,6253282&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Buscar por nombre de usuario

​

Usuario individual

cURL

shellscript

curl "https://api.x.com/2/users/by/username/XDevelopers?\
user.fields=created_at,description,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

Varios usuarios

cURL

shellscript

curl "https://api.x.com/2/users/by?\
usernames=XDevelopers,X,elonmusk&\
user.fields=created_at,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Campos disponibles

Campo	Descripción
created_at	Fecha de creación de la cuenta
description	Biografía del usuario
profile_image_url	URL del avatar
verified	Estado de verificación
public_metrics	Número de seguidores/seguidos
location	Ubicación definida por el usuario
url	Sitio web del usuario
protected	Estado de la cuenta protegida
pinned_tweet_id	ID de la Publicación fijada

---

​

Gestión de errores

​

Usuario no encontrado

{
  "errors": [
    {
      "resource_type": "user",
      "title": "Not Found Error",
      "detail": "Could not find user with username: [nonexistent_user]."
    }
  ]
}

​

Usuario protegido

Los datos de los usuarios protegidos se siguen devolviendo, pero no podrás acceder a sus Publicaciones a menos que los sigas.

---

​

Próximos pasos

Usuario autenticado

Obtén el usuario actual

Guía de integración

Conceptos clave y mejores prácticas

Referencia de la API

Documentación completa del endpoint