Cronologías

Los endpoints de Timelines te permiten recuperar Publicaciones de las cronologías de usuarios, feeds de menciones y feeds de inicio. Obtén el contenido que un usuario ha publicado, consulta qué Publicaciones lo mencionan o visualiza su cronología de inicio personalizada.

Descripción general

Publicaciones de usuario

Obtén publicaciones creadas por un usuario

Menciones de usuario

Obtén publicaciones que mencionan a un usuario

Cronología de inicio

Obtén el feed de inicio personalizado

Orden cronológico inverso

Publicaciones en orden cronológico

Endpoints

Method	Endpoint	Description
GET	`/2/users/:id/tweets`	Obtener las Publicaciones de un usuario
GET	`/2/users/:id/mentions`	Obtener las Publicaciones que mencionan a un usuario
GET	`/2/users/:id/timelines/reverse_chronological`	Obtener la cronología de inicio

Cronología de publicaciones de usuario

Obtén las publicaciones más recientes creadas por un usuario específico.

Funcionalidades

Hasta 3.200 Publicaciones más recientes
Excluir respuestas y retweets
Compatibilidad con paginación
Acceso al historial con filtrado por tiempo

Referencia de la API

Documentación completa del endpoint

Cronología de menciones de usuario

Obtén publicaciones que mencionen a un usuario específico.

Características

Hasta 800 menciones más recientes
Incluye respuestas y Publicaciones citadas
Compatibilidad con paginación

Inicio rápido

Obtener menciones de un usuario

Referencia de la API

Documentación completa del endpoint

Cronología de inicio en orden cronológico inverso

Recupera la cronología de inicio del usuario autenticado en orden cronológico inverso.

Características

Publicaciones de cuentas seguidas
3.200 publicaciones más recientes (o 7 días)
Excluye la clasificación algorítmica
Requiere autenticación de usuario

Este endpoint requiere OAuth 1.0a User Context o OAuth 2.0 Authorization Code with PKCE.

Inicio rápido

Obtén la cronología principal de un usuario

Referencia de la API

Documentación completa del endpoint

Opciones de filtrado

Parámetro exclude

Filtra tipos específicos de Publicaciones:

Value	Effect
`retweets`	Excluir retweets
`replies`	Excluir respuestas

curl "https://api.x.com/2/users/123/tweets?exclude=retweets,replies" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Filtrado por tiempo

Parámetro	Descripción
`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

Primeros pasos

Requisitos previos

Una cuenta de desarrollador aprobada
Un Project and App en la Consola de desarrollador
Las claves y tokens de tu App

Inicio rápido de la cronología de inicio

Obtén la cronología de inicio de un usuario

Inicio rápido de menciones

Obtén las menciones de un usuario

Guía de integración

Conceptos clave y prácticas recomendadas

Código de ejemplo

Ejemplos de código listo para usar