Búsqueda de usuarios

Obtén perfiles de usuario por ID, nombre de usuario o del usuario autenticado

Los endpoints de búsqueda de usuarios te permiten recuperar información de perfil de uno o más usuarios. Busca usuarios por su id o nombre de usuario, u obtén detalles del usuario autenticado actualmente.

​

Descripción general

Por ID

Busca usuarios por su id único de usuario

Por nombre de usuario

Busca usuarios por su @handle

Varios usuarios

Obtén hasta 100 usuarios por solicitud

Usuario autenticado

Obtén detalles del usuario actual

---

​

Endpoints

Método	Endpoint	Descripción
GET	/2/users/:id	Obtener usuario por ID
GET	/2/users	Obtener usuarios por ID (hasta 100)
GET	/2/users/by/username/:username	Obtener usuario por nombre de usuario
GET	/2/users/by	Obtener usuarios por nombre de usuario (hasta 100)
GET	/2/users/me	Obtener usuario autenticado

---

​

Ejemplo de solicitud

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

​

Ejemplo de 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
    }
  }
}

---

​

Primeros pasos

Requisitos previos

• Una cuenta de desarrollador aprobada
• Un Project y una App en la Consola de desarrollador
• Las claves y tokens de tu App

Inicio rápido de búsqueda de usuarios

Buscar usuarios por ID o nombre de usuario

Inicio rápido de usuario autenticado

Obtener el perfil del usuario actual

Guía de integración

Conceptos clave y prácticas recomendadas

Referencia de la API

Documentación completa del endpoint