> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio rápido del usuario autenticado

> Obtén el perfil del usuario autenticado actualmente

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

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

<Note>
  **Requisitos previos**

  Antes de comenzar, necesitarás:

  * Una [cuenta de desarrollador](https://developer.x.com/en/portal/petition/essential/basic-info) con una App aprobada
  * Un token de acceso de usuario (OAuth 1.0a o OAuth 2.0 PKCE)
</Note>

***

<div id="get-the-authenticated-user">
  ## Obtener el usuario autenticado
</div>

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

<CodeGroup dropdown>
  ```bash cURL theme={null}
  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"
  ```

  ```python Python SDK theme={null}
  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"Nombre de usuario: {response.data.username}")
  print(f"ID: {response.data.id}")
  print(f"Seguidores: {response.data.public_metrics.followers_count}")
  ```

  ```javascript JavaScript SDK theme={null}
  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(`Nombre de usuario: ${response.data?.username}`);
  console.log(`ID: ${response.data?.id}`);
  console.log(`Seguidores: ${response.data?.public_metrics?.followers_count}`);
  ```
</CodeGroup>

***

<div id="response">
  ## Respuesta
</div>

```json theme={null}
{
  "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
    }
  }
}
```

***

<div id="use-case">
  ## Caso de uso
</div>

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

***

<div id="include-pinned-post">
  ## Incluir Publicación fijada
</div>

Solicita la Publicación fijada del usuario:

<CodeGroup dropdown>
  ```bash cURL theme={null}
  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"
  ```

  ```python Python SDK theme={null}
  from xdk import Client

  client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

  # Obtener al usuario autenticado con su Publicación fijada
  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}")
  # La Publicación fijada se encuentra en response.includes.tweets
  ```

  ```javascript JavaScript SDK theme={null}
  import { Client } from "@xdevplatform/xdk";

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

  // Obtener al usuario autenticado con su Publicación fijada
  const response = await client.users.getMe({
    userFields: ["pinned_tweet_id"],
    expansions: ["pinned_tweet_id"],
    tweetFields: ["created_at", "text"],
  });

  console.log(`Username: ${response.data?.username}`);
  // La Publicación fijada se encuentra en response.includes?.tweets
  ```
</CodeGroup>

<div id="response-with-expansion">
  ### Respuesta con expansiones
</div>

```json theme={null}
{
  "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"
      }
    ]
  }
}
```

***

<div id="available-fields">
  ## Campos disponibles
</div>

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

***

<div id="authentication-requirement">
  ## Requisito de autenticación
</div>

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

Usa uno de los siguientes métodos:

* [OAuth 1.0a User Context](/es/resources/fundamentals/authentication)
* [OAuth 2.0 Authorization Code with PKCE](/es/resources/fundamentals/authentication#oauth-2-0-authorization-code-flow-with-pkce-2)

***

<div id="next-steps">
  ## Próximos pasos
</div>

<CardGroup cols={2}>
  <Card title="Búsqueda de usuarios" icon="users" href="/es/x-api/users/lookup/quickstart/user-lookup">
    Busca otros usuarios
  </Card>

  <Card title="Guía de integración" icon="book" href="/es/x-api/users/lookup/integrate">
    Conceptos clave y mejores prácticas
  </Card>

  <Card title="Referencia de la API" icon="code" href="/es/x-api/users/authenticated-user-lookup">
    Documentación completa del endpoint
  </Card>
</CardGroup>