Inicio rápido de búsqueda de usuarios

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

Requisitos previosAntes de comenzar, necesitarás:

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

Buscar por id

Usuario individual

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtener usuario por ID
response = client.users.get(
    "2244994945",
    user_fields=["created_at", "description", "verified", "public_metrics"]
)

print(f"Nombre: {response.data.name}")
print(f"Usuario: {response.data.username}")
print(f"Seguidores: {response.data.public_metrics.followers_count}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Obtener usuario por ID
const response = await client.users.get("2244994945", {
  userFields: ["created_at", "description", "verified", "public_metrics"],
});

console.log(`Nombre: ${response.data?.name}`);
console.log(`Usuario: ${response.data?.username}`);
console.log(`Seguidores: ${response.data?.public_metrics?.followers_count}`);

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

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

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtener varios usuarios por ID
response = client.users.get_users(
    ids=["2244994945", "783214", "6253282"],
    user_fields=["username", "verified"]
)

for user in response.data:
    print(f"{user.username} - Verificado: {user.verified}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Obtener varios usuarios por ID
const response = await client.users.getUsers({
  ids: ["2244994945", "783214", "6253282"],
  userFields: ["username", "verified"],
});

response.data?.forEach((user) => {
  console.log(`${user.username} - Verificado: ${user.verified}`);
});

Buscar por nombre de usuario

Usuario individual

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtener usuario por nombre de usuario
response = client.users.get_by_username(
    "XDevelopers",
    user_fields=["created_at", "description", "verified"]
)

print(f"ID: {response.data.id}")
print(f"Nombre: {response.data.name}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Obtener usuario por nombre de usuario
const response = await client.users.getByUsername("XDevelopers", {
  userFields: ["created_at", "description", "verified"],
});

console.log(`ID: ${response.data?.id}`);
console.log(`Nombre: ${response.data?.name}`);

Varios usuarios

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtener varios usuarios por sus nombres de usuario
response = client.users.get_users_by_usernames(
    usernames=["XDevelopers", "X", "elonmusk"],
    user_fields=["created_at", "verified"]
)

for user in response.data:
    print(f"{user.username} - {user.created_at}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Obtener varios usuarios por sus nombres de usuario
const response = await client.users.getUsersByUsernames({
  usernames: ["XDevelopers", "X", "elonmusk"],
  userFields: ["created_at", "verified"],
});

response.data?.forEach((user) => {
  console.log(`${user.username} - ${user.created_at}`);
});

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

Descripción general

Publicaciones

Usuarios

Mensajes directos

Me gusta

Listas

Spaces

Comunidades

Notas de la comunidad

Tendencias

Noticias

Contenido multimedia

Actividad en X

Uso

Conexiones de streaming

Cumplimiento

Enterprise v2

Flujos de Me gusta

GNIP 2.0

Inicio rápido de búsqueda de usuarios

Buscar por id

Usuario individual

Respuesta

Múltiples usuarios

Buscar por nombre de usuario

Usuario individual

Varios usuarios

Campos disponibles

Gestión de errores

Usuario no encontrado

Usuario protegido

Próximos pasos

Usuario autenticado

Guía de integración

Referencia de la API

​Buscar por id

​Usuario individual

​Respuesta

​Múltiples usuarios

​Buscar por nombre de usuario

​Usuario individual

​Varios usuarios

​Campos disponibles

​Gestión de errores

​Usuario no encontrado

​Usuario protegido

​Próximos pasos

Usuario autenticado

Guía de integración

Referencia de la API

Buscar por id

Usuario individual

Respuesta

Múltiples usuarios

Buscar por nombre de usuario

Usuario individual

Varios usuarios

Campos disponibles

Gestión de errores

Usuario no encontrado

Usuario protegido

Próximos pasos