Inicio rápido del usuario autenticado

Obtén el perfil del usuario autenticado actualmente

Esta guía te muestra cómo obtener el perfil del usuario actualmente autenticado usando el endpoint /me.

Requisitos previos

Antes de comenzar, necesitarás:

• Una cuenta de desarrollador con una App aprobada
• Un token de acceso de usuario (OAuth 1.0a o OAuth 2.0 PKCE)

---

Obtener el usuario autenticado

Haz una solicitud al endpoint /me con un token de acceso de usuario (User Access Token):

cURL

shellscript

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"

---

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,
    "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:

• Verificar la autenticación — Confirmar que el usuario esté autenticado correctamente
• Obtener el ID de usuario — Obtener el ID del usuario autenticado para otras llamadas a la API
• Personalizar experiencias — Mostrar el perfil del usuario en tu app
• Solicitudes en nombre de un usuario — Saber a nombre de quién estás haciendo solicitudes

---

Incluir Publicación fijada

Solicita la Publicación fijada del usuario:

cURL

shellscript

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"

Respuesta con expansiones

{
  "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"
      }
    ]
  }
}

---

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	Cantidad de seguidores/seguidos
location	Ubicación definida por el usuario
url	Sitio web del usuario
protected	Estado de cuenta protegida
pinned_tweet_id	Identificador de la Publicación fijada

---

Requisito de autenticación

El endpoint /me requiere autenticación con User Context. No se admite la autenticación App-only (Bearer Token).

Usa uno de los siguientes métodos:

• OAuth 1.0a User Context
• OAuth 2.0 Authorization Code with PKCE

---

Próximos pasos

Búsqueda de usuarios

Busca otros usuarios

Guía de integración

Conceptos clave y mejores prácticas

Referencia de la API

Documentación completa del endpoint