Inicio rápido de usuario autenticado

Esta guía te guía en la recuperación del perfil del usuario autenticado actualmente usando el endpoint /me.

Requisitos previosAntes de comenzar, necesitarás:

Una cuenta de desarrollador con una App aprobada
User Access Token (OAuth 1.0a u OAuth 2.0 PKCE)

Obtener el usuario autenticado

Realiza una solicitud al endpoint /me con un User Access Token:

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Obtener el usuario autenticado
response = client.users.get_me(
    user_fields=["created_at", "description", "verified", "public_metrics", "profile_image_url"]
)

print(f"Username: {response.data.username}")
print(f"ID: {response.data.id}")
print(f"Followers: {response.data.public_metrics.followers_count}")

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

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Obtener el usuario autenticado
const response = await client.users.getMe({
  userFields: ["created_at", "description", "verified", "public_metrics", "profile_image_url"],
});

console.log(`Username: ${response.data?.username}`);
console.log(`ID: ${response.data?.id}`);
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,
    "profile_image_url": "https://pbs.twimg.com/profile_images/...",
    "public_metrics": {
      "followers_count": 583423,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

Caso de uso

El endpoint /me es esencial cuando:

Verificas autenticación — Confirma que el usuario está autenticado correctamente
Obtienes el user ID — Recupera el ID del usuario autenticado para otras llamadas a la API
Personalizas experiencias — Muestra el perfil del usuario en tu app
Solicitudes en su nombre — Sabes en nombre de quién estás haciendo las solicitudes

Incluir Post fijado

Solicita el Post fijado del usuario:

cURL

curl "https://api.x.com/2/users/me?\
user.fields=pinned_tweet_id&\
expansions=pinned_tweet_id&\
tweet.fields=created_at,text" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Obtener usuario autenticado con Post fijado
response = client.users.get_me(
    user_fields=["pinned_tweet_id"],
    expansions=["pinned_tweet_id"],
    tweet_fields=["created_at", "text"]
)

print(f"Username: {response.data.username}")
# El Post fijado está en response.includes.tweets

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

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Obtener usuario autenticado con Post fijado
const response = await client.users.getMe({
  userFields: ["pinned_tweet_id"],
  expansions: ["pinned_tweet_id"],
  tweetFields: ["created_at", "text"],
});

console.log(`Username: ${response.data?.username}`);
// El Post fijado está en response.includes?.tweets

Respuesta con expansion

Example response

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "XDevelopers",
    "pinned_tweet_id": "1234567890"
  },
  "includes": {
    "tweets": [
      {
        "id": "1234567890",
        "text": "Welcome to my profile!",
        "created_at": "2024-01-01T00:00:00.000Z"
      }
    ]
  }
}

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

Requisito de autenticación

El endpoint /me requiere autenticación con contexto de usuario. La autenticación App-Only (Bearer Token) no es compatible.

Usa uno de estos:

Próximos pasos

User lookup

Consulta otros usuarios

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 usuario autenticado

Obtener el usuario autenticado

Respuesta

Caso de uso

Incluir Post fijado

Respuesta con expansion

Fields disponibles

Requisito de autenticación

Próximos pasos

User lookup

Guía de integración

Referencia de la API

​Obtener el usuario autenticado

​Respuesta

​Caso de uso

​Incluir Post fijado

​Respuesta con expansion

​Fields disponibles

​Requisito de autenticación

​Próximos pasos

User lookup

Guía de integración

Referencia de la API

Obtener el usuario autenticado

Respuesta

Caso de uso

Incluir Post fijado

Respuesta con expansion

Fields disponibles

Requisito de autenticación

Próximos pasos