Inicio rápido de la cronología de inicio

Obtén la cronología de inicio de un usuario en orden cronológico inverso

Esta guía te explica cómo hacer tu primera solicitud al endpoint de la cronología de inicio en orden cronológico inverso.

Requisitos previos

Antes de comenzar, necesitarás:

• Una cuenta de desarrollador con una App aprobada
• Tokens de acceso de usuario (este endpoint requiere autenticación de usuario)

---

​

Paso 1: Obtener el ID de usuario

Necesitas el ID de usuario de la cuenta cuya timeline de inicio quieres recuperar. Puedes obtenerlo usando el endpoint de consulta por nombre de usuario:

cURL

shellscript

curl "https://api.x.com/2/users/by/username/XDevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"

La respuesta incluye el ID de usuario:

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "XDevelopers"
  }
}

---

​

Paso 2: Solicitar el timeline de inicio

Realiza una solicitud GET con el ID de usuario y el token de acceso de usuario (User Access Token):

cURL

shellscript

curl "https://api.x.com/2/users/2244994945/timelines/reverse_chronological" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

---

​

Paso 3: Revisar la respuesta

{
  "data": [
    {
      "id": "1524796546306478083",
      "text": "Today marks the launch of Devs in the Details...",
      "edit_history_tweet_ids": ["1524796546306478083"]
    },
    {
      "id": "1524468552404668416",
      "text": "Join us tomorrow for a discussion about bots...",
      "edit_history_tweet_ids": ["1524468552404668416"]
    }
  ],
  "meta": {
    "result_count": 2,
    "newest_id": "1524796546306478083",
    "oldest_id": "1524468552404668416",
    "next_token": "7140dibdnow9c7btw421dyz6jism75z99gyxd8egarsc4"
  }
}

---

​

Paso 4: Añade campos y expansions

Solicita datos adicionales mediante parámetros de consulta:

cURL

shellscript

curl "https://api.x.com/2/users/2244994945/timelines/reverse_chronological?\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,verified&\
max_results=10" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

---

​

Paso 5: Paginar los resultados

Los SDK se encargan de la paginación automáticamente. Para cURL, utiliza el next_token de la respuesta para obtener más resultados:

curl "https://api.x.com/2/users/2244994945/timelines/reverse_chronological?\
max_results=10&\
pagination_token=7140dibdnow9c7btw421dyz6jism75z99gyxd8egarsc4" \
  -H "Authorization: Bearer $USER_ACCESS_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	—

---

​

Próximos pasos

Menciones de usuario

Obtén Publicaciones que mencionan a un usuario

Guía de integración

Conceptos clave y mejores prácticas

Referencia de la API

Documentación completa del endpoint

Guía de paginación

Navega por conjuntos de resultados de gran tamaño