Inicio rápido de User Lookup

Esta guía te guía en la consulta de usuarios por su ID o username.

Requisitos previosAntes de comenzar, necesitarás:

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

Buscar por ID

Un solo usuario

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"Name: {response.data.name}")
print(f"Username: {response.data.username}")
print(f"Followers: {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(`Name: ${response.data?.name}`);
console.log(`Username: ${response.data?.username}`);
console.log(`Followers: ${response.data?.public_metrics?.followers_count}`);

Respuesta

Example response

{
  "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 múltiples 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} - Verified: {user.verified}")

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

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

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

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

Buscar por username

Un solo usuario

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 username
response = client.users.get_by_username(
    "XDevelopers",
    user_fields=["created_at", "description", "verified"]
)

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

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

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

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

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

Múltiples 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 múltiples usuarios por username
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 múltiples usuarios por username
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}`);
});

Fields disponibles

Field	Descripción
`created_at`	Fecha de creación de la cuenta
`description`	Bio del usuario
`profile_image_url`	URL del avatar
`verified`	Estado de verificación
`public_metrics`	Recuentos de seguidores/seguidos
`location`	Ubicación definida por el usuario
`url`	Sitio web del usuario
`protected`	Estado de cuenta protegida
`pinned_tweet_id`	ID del Post fijado

Gestionar 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 Posts 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

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Inicio rápido de User Lookup

Buscar por ID

Un solo usuario

Respuesta

Múltiples usuarios

Buscar por username

Un solo usuario

Múltiples usuarios

Fields disponibles

Gestionar errores

Usuario no encontrado

Usuario protegido

Próximos pasos

Usuario autenticado

Guía de integración

Referencia de la API

​Buscar por ID

​Un solo usuario

​Respuesta

​Múltiples usuarios

​Buscar por username

​Un solo usuario

​Múltiples usuarios

​Fields disponibles

​Gestionar errores

​Usuario no encontrado

​Usuario protegido

​Próximos pasos

Usuario autenticado

Guía de integración

Referencia de la API

Buscar por ID

Un solo usuario

Respuesta

Múltiples usuarios

Buscar por username

Un solo usuario

Múltiples usuarios

Fields disponibles

Gestionar errores

Usuario no encontrado

Usuario protegido

Próximos pasos