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

# Explora los Posts y menciones de un usuario con la X API v2

> Los endpoints de timeline de Posts de usuario y timeline de menciones de usuario permiten a los desarrolladores recuperar los Posts públicos compuestos por, o que mencionan a, un usuario.

## Introducción

Mientras que el [endpoint recent search](/x-api/posts/search/introduction) solo te permite obtener Posts publicados en los últimos 7 días, los endpoints de timeline de Posts de usuario y timeline de menciones de usuario te permiten recuperar Posts y menciones más antiguos que los últimos 7 días, para un usuario autorizado (usando el user ID). Los desarrolladores pueden usar estos endpoints para estudiar temas, entidades y sentimiento de los Posts del timeline o menciones de un usuario. En este tutorial te mostraremos cómo explorar los Posts y menciones de un usuario usando los endpoints user Tweet timeline y user mention timeline.

## Requisitos previos

* Para usar los endpoints user Tweet timeline y user mention timeline, necesitarás tener una cuenta de desarrollador válida.
* También necesitarás un [Project](/resources/fundamentals/developer-apps) creado.
* Debes haberte [registrado](https://developer.x.com/en/portal/petition/essential/basic-info) para una cuenta de desarrollador y haber activado la [nueva experiencia de Developer Console](https://developer.x.com/en/portal/opt-in.html).
* El acceso está disponible con claves y tokens activos para una App de desarrollador que esté asociada a un [Project](/resources/fundamentals/developer-apps) creado en la [Developer Console](/resources/fundamentals/developer-portal).
* Un Bearer Token de tu App en la [X Developer Console](/resources/fundamentals/developer-portal).
* Si no tienes una cuenta de desarrollador aprobada, puedes [solicitar una](https://developer.x.com/en/apply-for-access).

## Cuenta de desarrollador aprobada

Si aún no tienes una, puedes [solicitarla](https://developer.x.com/en/apply-for-access).

## Crear un Project y conectar una App

En la [Developer Console](https://developer.x.com/en/portal/dashboard), haz clic en crear una nueva App.

<Frame>
  <img src="https://mintcdn.com/x-preview/l3xgUBEfGdfuOen0/images/projects.png.twimg.1920.png?fit=max&auto=format&n=l3xgUBEfGdfuOen0&q=85&s=9264e7d6cb9aa2dbeeaabbd836302d74" width="880" height="397" data-path="images/projects.png.twimg.1920.png" />
</Frame>

Dale un nombre, selecciona el caso de uso apropiado y proporciona una descripción del Project. A continuación, puedes crear una nueva App o conectar una [App](/resources/fundamentals/developer-apps) existente (una App es un contenedor para tus API keys que necesitas para hacer una solicitud HTTP a la X API).

<Frame>
  <img src="https://mintcdn.com/x-preview/s_D1jGy1nLdDmXkd/images/add-your-app.png.twimg.1920.png?fit=max&auto=format&n=s_D1jGy1nLdDmXkd&q=85&s=c659b4cfe02d956faad3021a7beb2c9d" width="880" height="569" data-path="images/add-your-app.png.twimg.1920.png" />
</Frame>

Haz clic en 'create a new App instead' y dale un nombre a tu App para crear una nueva App.

<Frame>
  <img src="https://mintcdn.com/x-preview/l3xgUBEfGdfuOen0/images/last-step-name-your-app.png.twimg.1920.png?fit=max&auto=format&n=l3xgUBEfGdfuOen0&q=85&s=c62db12722d6c1048d2522c76498a9db" width="880" height="558" data-path="images/last-step-name-your-app.png.twimg.1920.png" />
</Frame>

Una vez que hagas clic en completar, obtendrás tus API keys y el bearer token que podrás usar para conectarte a los nuevos endpoints de la X API v2.

<Frame>
  <img src="https://mintcdn.com/x-preview/l3xgUBEfGdfuOen0/images/here-are-your-keys.png.twimg.1920.png?fit=max&auto=format&n=l3xgUBEfGdfuOen0&q=85&s=7c7385eed29546412c31c659ef6490c4" width="880" height="897" data-path="images/here-are-your-keys.png.twimg.1920.png" />
</Frame>

Haz clic en el (+) junto a API key, API secret key y Bearer token y copia estos valores en un lugar seguro de tu máquina local. Los necesitarás para hacer las llamadas a la API en el siguiente paso.

Nota: Las claves de la captura de arriba están ocultas, pero en tu propia Developer Console podrás ver los valores reales de la API key, la API secret key y el Bearer token.

## Cómo obtener el user ID de un usuario para usarlo en los endpoints user Tweet timeline y user mention timeline

Los endpoints user Tweet timeline y user mention timeline te permiten obtener Posts usando el user ID. Para obtener el user ID a partir de un nombre de usuario, puedes usar el nuevo [endpoint user lookup v2](/x-api/users/lookup/quickstart/user-lookup). Reemplaza USER\_NAME con el nombre de usuario de tu elección y XXXX con tu propio bearer token obtenido arriba.

```bash theme={null}
  curl --request GET 'https://api.x.com/2/users/by/username/USER_NAME --header 'Authorization: Bearer XXXXXX'
```

Verás el user ID en la respuesta como se muestra a continuación:

```json theme={null}
{
   "data": {
       "id": "2244994945",
       "name": "Developers",
       "username": "XDevelopers"
   }
}
```

## Conectarse a los endpoints user Tweet timeline y user mention timeline

Para obtener el user Tweet timeline de un usuario, ejecuta el siguiente comando curl en tu terminal (asegúrate de reemplazar USER\_ID con el user ID de tu elección y XXXX con tu propio bearer token obtenido arriba)

```bash theme={null}
curl --request GET 'https://api.x.com/2/users/USER_ID/tweets' --header 'Authorization: Bearer XXXXXX'
```

Verás que la respuesta JSON para estas solicitudes contiene por defecto el ID y el texto de los Posts (ejemplo abajo).

```yaml theme={null}
{
   "id": "1334200897081987072",
   "text": "👀 If you are new to the X API v2, check out this step-by-step guide to making your first request https://t.co/4rZqThpSbp"
}
```

Si quieres que se devuelvan campos adicionales como parte de la respuesta (como información del usuario, campos adicionales del Tweet como context annotations, etc.), deberás especificar esos campos explícitamente en tu respuesta. Aprende cómo hacerlo en la [guía sobre el uso de fields y expansions](/x-api/fundamentals/data-dictionary/reference#how-to-use-fields-and-expansions).

También puedes obtener estos Posts usando los lenguajes de programación de tu elección. Consulta nuestro código de ejemplo en Python, Node (JavaScript), Java y Ruby para los endpoints user Tweet timeline y user mention timeline en nuestro [repositorio de Github](https://github.com/xdevplatform/Twitter-API-v2-sample-code).

## Explorando los Posts del usuario

Una vez que sepas cómo obtener Posts usando los endpoints user Tweet timeline y user mention timeline, puedes empezar a explorar sus Posts. Por ejemplo, si quisieras identificar entidades nombradas comunes presentes en las menciones de un usuario, puedes hacer lo siguiente:

En la solicitud a la API, especifica que quieres que se devuelva el objeto context\_annotations en las respuestas del Tweet:

```bash theme={null}
curl --request GET 'https://api.x.com/2/users/USER_ID/mentions?tweet.fields=context_annotations' --header 'Authorization: Bearer XXXXXX'
```

En la respuesta, verás si hay entidades nombradas presentes en las menciones. Aquí tienes un ejemplo:

```json theme={null}
{
   "domain": {
       "id": "47",
       "name": "Brand",
       "description": "Brands and Companies"
   },
   "entity": {
       "id": "783214",
       "name": "X"
   }
}
```

Si quisieras ver qué entidades populares aparecen en tus menciones, podrías llevar un conteo de entidades populares parseando cada Tweet en las menciones.

Si quisieras explorar la URL de imagen de vista previa para todos los Posts de tu timeline que contienen media, puedes hacer lo siguiente:

En la solicitud a la API, especifica que quieres el preview\_image\_url en los campos tweet.media y las expansions attachments.media\_keys

```bash theme={null}
curl --request GET 'https://api.x.com/2/users/2244994945/mentions?max_results=100&media.fields=preview_image_url&expansions=attachments.media_keys' --header 'Authorization: Bearer XXXXXX'
```

En la respuesta, verás el preview\_image\_url en el objeto includes como se muestra a continuación:

```json theme={null}
{
   "includes": {
       "media": [
           {
               "media_key": "16_1334657439640121344",
               "preview_image_url": "https://pbs.twimg.com/tweet_video_thumb/EoWn3rqU8AAtFWL.jpg",
               "type": "animated_gif"
           }
       ]
   }
}
```

Una vez que entiendas cómo navegar por los Posts de un usuario, también puedes usar otras APIs y servicios para hacer más cosas con los Posts. A continuación tienes algunos recursos útiles al usar los endpoints user Tweet timeline y user mention timeline.

## Recursos

* Aprende más sobre los [endpoints user Tweet timeline y user mention timeline](/x-api/posts/timelines/introduction).
* Consulta la [referencia de API del endpoint user Tweet timeline](/x-api/users/get-posts) para conocer más sobre lo que ofrece.
* Consulta la [referencia de API del endpoint user mention timeline](/x-api/users/get-mentions) para conocer más sobre lo que ofrece.
* Inspírate leyendo nuestros otros [tutoriales](/tutorials).
