Cronología de menciones del usuario

Obtén publicaciones que mencionan a un usuario específico

Esta guía te muestra cómo recuperar Publicaciones que mencionan a un usuario específico.

Requisitos previos

Antes de comenzar, necesitarás:

• Una cuenta de desarrollador con una App aprobada
• El Bearer Token de tu App (para datos públicos) o el User Access Token (para métricas privadas)

---

​

Obtener menciones de un usuario

1. Obtener el ID de usuario

   Obtén el ID de usuario usando el endpoint de búsqueda de usuarios. Por ejemplo, @XDevelopers tiene el ID de usuario 2244994945.

2. Solicitar la cronología de menciones

   cURL

   shellscript

   curl "https://api.x.com/2/users/2244994945/mentions?\
   tweet.fields=created_at,public_metrics,author_id&\
   expansions=author_id&\
   user.fields=username,verified&\
   max_results=10" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   
3. Revisa la respuesta

   {
     "data": [
       {
         "id": "1301573587187331074",
         "text": "Hey @XDevelopers, ¡me encanta la nueva API!",
         "author_id": "1234567890",
         "created_at": "2024-01-15T10:30:00.000Z",
         "public_metrics": {
           "retweet_count": 5,
           "reply_count": 2,
           "like_count": 42,
           "quote_count": 1
         }
       }
     ],
     "includes": {
       "users": [
         {
           "id": "1234567890",
           "username": "developer",
           "name": "Dev Person",
           "verified": false
         }
       ]
     },
     "meta": {
       "newest_id": "1301573587187331074",
       "oldest_id": "1301573587187331074",
       "result_count": 1,
       "next_token": "t3buvdr5pujq9g7bggsnf3ep2ha28"
     }
   }
   

---

​

Filtrar menciones

​

Excluir respuestas

Obtén solo las Publicaciones originales que mencionen al usuario:

cURL

shellscript

curl "https://api.x.com/2/users/2244994945/mentions?\
exclude=replies&\
max_results=10" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

Obtener menciones en un rango de tiempo

cURL

shellscript

curl "https://api.x.com/2/users/2244994945/mentions?\
start_time=2024-01-01T00%3A00%3A00Z&\
end_time=2024-01-31T23%3A59%3A59Z" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Parámetros comunes

Parámetro	Descripción	Valor predeterminado
max_results	Resultados por página (1-100)	10
start_time	Marca de tiempo de la Publicación más antigua (ISO 8601)	—
end_time	Marca de tiempo de la Publicación más reciente (ISO 8601)	—
since_id	Devuelve Publicaciones posteriores a este ID	—
until_id	Devuelve Publicaciones anteriores a este ID	—
exclude	Excluye retweets, replies o ambos	—
pagination_token	Token para la página siguiente	—

---

​

Próximos pasos

Cronología de inicio

Obtén la cronología de inicio del usuario

Guía de integración

Conceptos clave y prácticas recomendadas

Referencia de la API

Documentación completa del endpoint

Guía de paginación

Navega por grandes conjuntos de resultados