Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://generaltranslation.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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 previosAntes 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
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
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
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ámetroDescripciónValor predeterminado
max_resultsResultados por página (1-100)10
start_timeMarca de tiempo de la Publicación más antigua (ISO 8601)—
end_timeMarca de tiempo de la Publicación más reciente (ISO 8601)—
since_idDevuelve Publicaciones posteriores a este ID—
until_idDevuelve Publicaciones anteriores a este ID—
excludeExcluye 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