Comparación de los endpoints de timelines de la X API
Los endpoints v2 reverse chronological timeline, user Posts timeline y user mention timeline reemplazan a los endpoints v1.1 statuses/home_timeline, v1.1 statuses/user_timeline y v1.1 statuses/mentions_timeline respectivamente. Si tienes código, apps o herramientas que utilizan una versión anterior de este endpoint y estás considerando migrar al endpoint más reciente de X API v2, entonces esta guía es para ti. Para obtener 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:- Home timeline en cronología inversa
- Timeline de Posts de usuario
- Timeline de menciones de usuario
Home timeline en cronología inversa
Las siguientes tablas comparan los endpoints estándar v1.1 y de X API v2 de home timeline:| Description | Standard v1.1 | X API v2 |
| Documentación | Referencia de la API | Referencia de la API |
| Métodos HTTP admitidos | GET | GET |
| Host domain | https://api.x.com | https://api.x.com |
| Endpoint paths | /1.1/statuses/home_timeline.json | /2/users/:id/timelines/reverse_chronological |
| 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 1.0a User Context OAuth 2.0 Authorization Code Flow with PKCE |
| Límites de tasa de solicitud | 15 solicitudes por 15 minutos con OAuth 1.0a User Context Límite de solicitudes: 100,000 en un período de 24 horas. | 180 solicitudes por ventana de 15 minutos |
| Posts predeterminados por respuesta | 15 | 100 |
| Posts máximos por respuesta | 800 | Este endpoint devuelve todos los Posts creados en un timeline durante los últimos 7 días, así como los 800 más recientes independientemente de la fecha de creación. |
| Proporciona historial de edición de Post | ✔ | ✔ |
| Posts históricos disponibles | Los 800 Posts más recientes, incluidos Retweets | Los 3,200 Posts más recientes, incluidos Retweets |
| Opciones de navegación del timeline | since_id (exclusivo) usado para sondeo de actualizacionesmax_id (inclusivo) | start_timeend_time since_id(exclusivo) usado para sondeo de actualizaciones until_id (exclusivo) |
| Parámetros opcionales para refinar resultados | countexclude_repliesinclude_rtstrim_usertweet_modesince_idmax_id | max_resultsexclude(retweets,replies)tweet.fieldsuser.fieldsplace.fieldsmedia.fieldspoll.fieldsexpansionsstart_timeend_timesince_iduntil_id |
| Admite solicitar y recibir annotations | N/A | Si se incluyen annotations en tweet.fields, los resultados se anotarán con datos de annotation inferidos basados en el texto del Post, como ‘Music Genre’ y ‘Folk Music’ o ‘Musician’ y ‘Dolly Parton’ |
| Admite solicitar y recibir métricas específicas de Post | N/A | Si se incluyen annotations en tweet.fields, los resultados se anotarán con public_metrics por Post, incluidos retweet_count, reply_count, quote_count, like_count, impression_count y bookmark_count, non_public_metrics incluyendo impression_count, user_profile_clicks, url_link_clicks y engagements.Métricas de media adicionales como view_count y métricas de reproducción de video. organic_metrics y promoted_metrics adicionales disponibles con User Context para Posts promocionados. |
| Admite solicitar y recibir conversation_id | N/A | Devuelve un campo conversation_id donde el valor representa el primer Post publicado en un hilo de respuestas para ayudarte a hacer seguimiento de las conversaciones. |
| Formato JSON de Post | Formato de datos Standard v1.1 | Formato X API v2 (determinado por los parámetros de solicitud fields y expansions, no es retrocompatible con 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 resultados | Cronológico inverso | Cronológico inverso |
| Paginación de resultados | N/A debe usar navegación por ID de Post | Los resultados pueden revisarse avanzando o retrocediendo usando un pagination_token |
| Requiere el uso de credenciales de una developer App asociada a un Project | ✔ |
Timeline de Posts de usuario
Las siguientes tablas comparan los endpoints estándar v1.1 y de X API v2 de user Post timeline:| Description | Standard v1.1 | X API v2 |
| Documentación | Referencia de la API | Referencia de la API |
| Métodos HTTP admitidos | GET | GET |
| Host domain | https://api.x.com | https://api.x.com |
| Endpoint paths | /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 solicitud | 900 solicitudes por 15 min con OAuth 1.0a User Context 1500 solicitudes por 15 min con OAuth 2.0 App-Only Límite de solicitudes: 100,000 en un período de 24 horas. | 900 solicitudes por ventana de 15 minutos con OAuth 1.0a User Context 1500 solicitudes por ventana de 15 minutos con OAuth 2.0 App-Only |
| Posts predeterminados por respuesta | 15 | 10 |
| Posts máximos por respuesta | 200 | 100 |
| Posts históricos disponibles | Los 3,200 Posts más recientes, incluidos Retweets | Los 3,200 Posts más recientes, incluidos Retweets |
| Opciones de navegación del timeline | since_id (exclusivo) usado para sondeo de actualizaciones max_id (inclusivo) | start_time end_time since_id (exclusivo) usado 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 | N/A | Devuelve resultados de Post con datos de annotation inferidos basados en el texto del Post, como ‘Music Genre’ y ‘Folk Music’ o ‘Musician’ y ‘Dolly Parton’ |
| Admite solicitar y recibir métricas específicas de Post | N/A | Devuelve resultados de Post con public_metrics disponibles por Post, incluidos retweet_count, reply_count, quote_count y like_count. Disponible con OAuth1.0a User Context: non_public_metrics adicionales, incluidas impression_count, user_profile_clicks, url_link_clicks. Métricas de media adicionales como view_count y métricas de reproducción de video. organic_metrics y promoted_metrics adicionales disponibles con OAuth 1.0a User Context para Posts promocionados. |
| Admite solicitar y recibir conversation_id | N/A | Devuelve un campo conversation_id donde el valor representa el primer Post publicado en un hilo de respuestas para ayudarte a hacer seguimiento de las conversaciones. |
| Formato JSON de Post | Formato de datos Standard v1.1 | Formato X API v2 (determinado por los parámetros de solicitud fields y expansions, no es retrocompatible con 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 resultados | Cronológico inverso | Cronológico inverso |
| Paginación de resultados | N/A debe usar navegación por ID de Post | Los resultados pueden revisarse avanzando o retrocediendo usando un pagination_token |
| Requiere el uso de credenciales de una developer App asociada a un Project | ✔ | |
| Proporciona historial de edición de Post | ✔ | ✔ |
Timeline de menciones de usuario
Las siguientes tablas comparan los endpoints estándar v1.1 y de X API v2 de user mention timeline| Description | Standard v1.1 | X API v2 |
| Documentación | Referencia de la API | Referencia de la API |
| Métodos HTTP admitidos | GET | GET |
| Host domain | https://api.x.com | https://api.x.com |
| Endpoint paths | /1.1/statuses/mentions_timeline.json | /2/users/:id/mentions |
| Parámetros requeridos | sin parámetros requeridos | ID de usuario establecido 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 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 |
| Posts predeterminados por respuesta | 15 | 10 |
| Posts máximos por respuesta | 200 | 100 |
| Posts históricos disponibles | Los 800 Posts más recientes | Los 800 Posts más recientes |
| Opciones de navegación del timeline | since_id (exclusivo) usado para sondeo de actualizaciones max_id (inclusivo) | start_time end_time since_id (exclusivo) usado para sondeo de actualizaciones until_id (exclusivo) |
| Parámetros opcionales para refinar 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 |
| Admite solicitar y recibir annotations | N/A | Devuelve resultados de Posts con datos de annotation inferidos basados en el texto del Post, como ‘Music Genre’ y ‘Folk Music’ o ‘Musician’ y ‘Dolly Parton’ |
| Admite solicitar y recibir métricas específicas de Post | N/A | Devuelve resultados de Post con public_metrics disponibles por Post, incluidos retweet_count, reply_count, quote_count y like_count. Disponible con OAuth 1.0a User Context: non_public_metrics adicionales, incluidas impression_count, user_profile_clicks, url_link_clicks. Métricas de media adicionales como view_count y métricas de reproducción de video. organic_metrics y promoted_metrics adicionales disponibles con OAuth 1.0a User Context para Posts promocionados |