Descripción general

Comparación de los endpoints de cronologías de X API

Los endpoints de cronología en orden cronológico inverso de v2, cronología de Publicaciones de usuario y cronología de menciones de usuario reemplazan respectivamente los endpoints v1.1 statuses/home_timeine, v1.1 statuses/user_timeline y v1.1 statuses/mentions_timeline. Si tienes código, aplicaciones o herramientas que usan una versión anterior de este endpoint y estás considerando migrar al nuevo endpoint de X API v2, esta guía es para ti. Para una guía de migración más detallada, consulta Migración de Standard v1.1 a X API v2.

Esta página contiene tres tablas comparativas:

• Cronología de inicio en orden cronológico inverso
• Cronología de Publicaciones de usuario
• Cronología de menciones de usuario

Cronología de inicio en orden cronológico inverso

Las siguientes tablas comparan los endpoints estándar de v1.1 y de X API v2 para la cronología de inicio:

Descripción	Standard v1.1	X API v2
Documentación	Referencia de la API	Referencia de la API
Métodos HTTP admitidos	GET	GET
Dominio de host	https://api.x.com	https://api.x.com
Rutas de endpoints	/1.1/statuses/home_timeline.json	/2/users/:id/timelines/reverse_chronological
Parámetros obligatorios	user_id o screen_name	Identificador de usuario establecido como parámetro de ruta :id
Autenticación	Contexto de usuario OAuth 1.0a	Contexto de usuario de OAuth 1.0a Flujo de código de autorización de OAuth 2.0 con PKCE
Límites de tasa de solicitudes	15 solicitudes por ventana de 15 minutos con contexto de usuario OAuth 1.0a Límite de solicitudes: 100.000 en un periodo de 24 horas.	180 solicitudes por ventana de 15 minutos
Publicaciones predeterminadas por respuesta	15	100
Número máximo de Publicaciones por respuesta	800	Este endpoint devuelve todas las Publicaciones creadas en una cronología durante los últimos 7 días, así como las 800 más recientes independientemente de la fecha de creación.
Proporciona el historial de edición de la Publicación	✔	✔
Publicaciones históricas disponibles	Las 800 Publicaciones más recientes, incluidos los Retweets	Las 3.200 Publicaciones más recientes, incluidos los Retweets
Opciones de navegación de la cronología	since_id (exclusivo), usado para sondeo de actualizaciones max_id (inclusivo)	start_time end_time since_id(exclusivo) utilizado para el sondeo de actualizaciones until_id (exclusivo)
Parámetros opcionales para refinar los resultados	count exclude_replies include_rts trim_user tweet_mode since_id max_id	max_results exclude(retweets,replies) tweet.fields user.fields place.fields media.fields poll.fields expansions start_time end_time since_id until_id
Permite solicitar y recibir anotaciones	N/D	Si las anotaciones se incluyen en tweet.fields, los resultados se anotarán con datos de anotación inferidos en función del texto de la Publicación, como «Género musical» y «Música folk» o «Músico» y «Dolly Parton»
Permite solicitar y recibir métricas específicas de Publicaciones metrics	N/D	Si se incluyen anotaciones en tweet.fields, los resultados se anotarán con public_metrics por Publicación, que incluyen retweet_count, reply_count, quote_count y like_count, y con non_public_metrics, que incluyen impression_count, user_profile_clicks, url_link_clicks. Métricas de medios adicionales como view_count y métricas de reproducción de video. Métricas adicionales de organic_metrics y promoted_metrics disponibles con Contexto de usuario para Publicaciones promocionadas.
Permite solicitar y obtener conversation_id	N/D	Devuelve un campo conversation_id cuyo valor representa la primera Publicación publicada en un hilo de respuestas para ayudarte a hacer un seguimiento de las conversaciones.
Formato JSON de la Publicación	Formato de datos estándar v1.1	Formato de X API v2 (determinado por los parámetros de solicitud de campos (fields) y expansions, no es compatible con los formatos de v1.1) Para obtener más información sobre cómo migrar del formato de datos Standard v1.1 al formato de datos de X API v2, visita nuestra guía de migración de formatos de datos.
Orden de los resultados	Cronológico inverso	Cronológico inverso
Paginación de resultados	N/D; se debe usar la navegación por id de la Publicación	Los resultados se pueden revisar avanzando o retrocediendo mediante un pagination_token
Requiere el uso de credenciales de una App de desarrollador asociada a un Proyecto		✔

Cronología de Publicaciones de un usuario

Las siguientes tablas comparan los endpoints estándar de la cronología de Publicaciones de un usuario en v1.1 y en X API v2:

Descripción	Standard v1.1	X API v2
Documentación	Referencia de la API	Referencia de la API
Métodos HTTP admitidos	GET	GET
Dominio del host	https://api.x.com	https://api.x.com
Rutas de endpoint	/1.1/statuses/user_timeline.json	/2/users/:id/tweets
Parámetros requeridos	user_id o screen_name	ID de usuario establecido como parámetro de ruta :id
Autenticación	OAuth 1.0a User Context OAuth 2.0 App-Only	OAuth 1.0a User Context OAuth 2.0 App-Only OAuth 2.0 Authorization Code with PKCE
Límites de tasa de solicitudes	900 solicitudes por intervalo de 15 minutos con OAuth 1.0a User Context 1500 solicitudes por intervalo de 15 minutos con OAuth 2.0 App-Only Límite máximo de solicitudes: 100,000 en un período de 24 horas.	900 solicitudes por intervalo de 15 minutos con OAuth 1.0a User Context 1500 solicitudes por intervalo de 15 minutos con OAuth 2.0 App-Only
Publicaciones predeterminadas por respuesta	15	10
Publicaciones máximas por respuesta	200	100
Publicaciones históricas disponibles	Las 3.200 Publicaciones más recientes, incluidos Retweets	Las 3.200 Publicaciones más recientes, incluidos Retweets
Opciones de navegación de la cronología	since_id (exclusivo) utilizado para sondeo de actualizaciones max_id (inclusivo)	start_time end_time since_id (exclusivo) utilizado para sondeo de actualizaciones until_id (exclusivo)
Parámetros opcionales para refinar resultados	count exclude_replies include_rts trim_user tweet_mode since_id max_id	max_results exclude(retweets,replies) tweet.fields user.fields place.fields media.fields poll.fields expansions start_time end_time since_id until_id
Admite solicitar y recibir annotations	No aplica	Devuelve resultados de Publicaciones con datos de anotaciones inferidas en función del texto de la Publicación, como ‘Music Genre’ y ‘Folk Music’ o ‘Musician’ y ‘Dolly Parton’
Admite solicitar y recibir métricas específicas de la Publicación /x-api/fundamentals/metrics	No aplica	Devuelve resultados de Publicaciones con public_metrics disponibles por Publicación, incluidas retweet_count, reply_count, quote_count y like_count. Disponible con OAuth1.0a User Context: Métricas adicionales non_public_metrics, incluidas impression_count, user_profile_clicks, url_link_clicks. Métricas de medios adicionales como view_count y métricas de reproducción de video. Métricas adicionales organic_metrics y promoted_metrics disponibles con OAuth 1.0a User Context para Publicaciones promocionadas.
Admite solicitar y recibir conversation_id	No aplica	Devuelve un campo conversation_id donde el valor representa la primera Publicación publicada en un hilo de respuestas para ayudarte a hacer un seguimiento de las conversaciones.
Formato JSON de la Publicación	Formato de datos Standard v1.1	Formato X API v2 (determinado por los parámetros de solicitud fields y expansions, no compatible con versiones anteriores de los formatos v1.1) Para obtener más información sobre cómo migrar del formato Standard v1.1 al formato X API v2, visita nuestra guía de migración de formatos de datos.
Orden de los resultados	Cronológico inverso	Cronológico inverso
Paginación de resultados	No aplica; se debe usar la navegación por ID de la Publicación	Los resultados se pueden revisar avanzando o retrocediendo mediante un pagination_token
Requiere el uso de credenciales de una App de desarrollador asociada con un Proyecto		✔
Proporciona historial de edición de la Publicación	✔	✔

Cronología de menciones del usuario

Las siguientes tablas comparan los endpoints de cronología de menciones de usuario de Standard v1.1 y X API v2

Descripción	Standard v1.1	X API v2
Documentación	Referencia de la API	Referencia de la API
Métodos HTTP compatibles	GET	GET
Dominio del host	https://api.x.com	https://api.x.com
Rutas de endpoint	/1.1/statuses/mentions_timeline.json	/2/users/:id/mentions
Parámetros obligatorios	sin parámetros obligatorios	ID de usuario definida como parámetro de ruta :id
Autenticación	OAuth 1.0a User Context	OAuth 1.0a User Context OAuth 2.0 App-Only OAuth 2.0 Authorization Code with PKCE
Límites de tasa de solicitud predeterminados	75 solicitudes por 15 min con OAuth 1.0a User Context Límite máximo de 100,000 solicitudes en un período de 24 horas.	180 solicitudes por ventana de 15 minutos con OAuth 1.0a User Context 450 solicitudes por ventana de 15 minutos con OAuth 2.0 App-Only
Publicaciones predeterminadas por respuesta	15	10
Máximo de Publicaciones por respuesta	200	100
Publicaciones históricas disponibles	Las 800 Publicaciones más recientes	Las 800 Publicaciones más recientes
Opciones de navegación de la cronología	since_id (exclusivo) usado para consultar actualizaciones max_id (inclusivo)	start_time end_time since_id (exclusivo) usado para consultar actualizaciones until_id (exclusivo)
Parámetros opcionales para afinar los resultados	count trim_user include_entities tweet_mode since_id max_id	max_results tweet.fields user.fields place.fields media.fields poll.fields expansions start_time end_time since_id until_id
Permite solicitar y recibir anotaciones	N/D	Devuelve resultados de Publicaciones con datos de anotación inferidos a partir del texto de la Publicación, como “Music Genre” y “Folk Music” o “Musician” y “Dolly Parton”
Permite solicitar y recibir métricas específicas de la Publicación	N/D	Devuelve resultados de Publicaciones con public_metrics disponibles para cada Publicación, incluidos retweet_count, reply_count, quote_count y like_count. Disponible con OAuth 1.0a User Context: Métricas adicionales non_public_metrics, incluidas impression_count, user_profile_clicks, url_link_clicks. Métricas adicionales de medios como view_count y métricas de reproducción de vídeo. Métricas adicionales organic_metrics y promoted_metrics disponibles con OAuth 1.0a User Context para Publicaciones promocionadas
Permite solicitar y recibir conversation_id	N/D	Devuelve un campo conversation_id donde el valor representa la primera Publicación publicada en un hilo de respuesta para ayudarte a hacer un seguimiento de las conversaciones.
Formato JSON de la Publicación	Formato de datos Standard v1.1	Formato de X API v2 (determinado por los parámetros de solicitud fields y expansions, no es compatible hacia atrás con los formatos v1.1) Para obtener más información sobre cómo migrar del formato Standard v1.1 al formato X API v2, visita nuestra guía de migración de formatos de datos.
Orden de los resultados	Cronológico inverso	Cronológico inverso
Parámetros de solicitud para paginación	N/D, se debe usar navegación por ID de Publicación	Los resultados se pueden revisar avanzando o retrocediendo usando pagination_token
Requiere el uso de credenciales de una App de desarrollador asociada con un Proyecto		✔
Proporciona historial de edición de la Publicación	✔	✔

Otros recursos de migración

Búsqueda de Publicaciones: Standard v1.1 a X API v2

Centro de migración de X API