Descripción general

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

Los endpoints de cronología inversa (orden cronológico inverso), cronología de Posts de usuario y cronología de menciones de usuario de v2 reemplazan, respectivamente, los endpoints v1.1 statuses/home_timeine, v1.1 statuses/user_timeline y v1.1 statuses/mentions_timeline. Si tienes código, Apps o herramientas que usan una versión anterior de este endpoint y estás considerando migrar al endpoint más reciente 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 inversa (orden cronológico inverso)
• Cronología de Posts de usuario
• Cronología de menciones de usuario

Cronología de inicio en orden cronológico inverso

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

Descripción	Versión estándar v1.1	X API v2
Documentación	Referencia de API	Referencia de la API
Métodos HTTP compatibles	GET	GET
Dominio del 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 requeridos	user_idoscreen_name	ID de usuario como parámetro de ruta :id
Autenticación	Contexto de usuario de OAuth 1.0a	OAuth 1.0a User Context Flujo de código de autorización de OAuth 2.0 con PKCE
Límites de frecuencia de solicitudes/Límites de volumen	15 solicitudes por cada ventana de 15 minutos con Contexto de usuario de OAuth 1.0a Límite de solicitudes: 100 000 en un periodo de 24 horas.	180 solicitudes por cada ventana de 15 minutos Límite de publicaciones: 500.000 con el acceso Essential 2 millones al usar el acceso Elevated 10 millones al usar el acceso de Academic Research
Publicaciones predeterminadas por respuesta	15	100
Número máximo de Posts 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 Posts	✔	✔
Publicaciones históricas disponibles	Los 800 Posts más recientes, incluidos los Retweets	Las 3,200 publicaciones más recientes, incluidos los Retweets
Opciones de navegación de la línea de tiempo	desde_id (exclusivo) utilizado para sondeo de actualizaciones max_id(incluido)	start_time final_hora since_id(exclusivo) usado para la consulta de actualizaciones until_id(exclusivo)
Parámetros opcionales para afinar los resultados	count exclude_replies include_rts trim_user tweet_mode since_id max_id	max_results excluir(retweets,respuestas) tweet.fields user.fields place.fields media.fields poll.fields expansions start_time end_time since_id until_id
Permite solicitar y recibirAnotaciones	No aplica	Si se incluyen anotaciones en tweet.fields, los resultados se anotarán con datos de anotación inferidos a partir del texto del Post, como’Género musical’y’Música folclórica’o’Músico’y’Dolly Parton’
Permite solicitar y recibir una Post específicaMétricas	N/A	Si se incluyen anotaciones entweet.fields, los resultados se etiquetarán como públicos_métricas por Post, incluidasretweet_count,reply_count,quote_countylike_count,non_public_metrics, incluidosimpression_count,user_profile_clicks,clics_enlaces_url. Métricas de medios adicionales, como vistas_recuento y métricas de reproducción de vídeo. Orgánico adicional_métricas y promocionados_métricas disponibles con Contexto de usuario para Posts promocionados.
Permite solicitar y recibirconversation_id	No aplica	Devuelve una conversación_campo id donde el valor representa el primer Post publicado en un hilo de respuestas para ayudarte a hacer el seguimiento de las conversaciones.
Formato JSON de Post	Formato de datos estándar v1.1	X API v2formato (determinado por los parámetros de solicitud fields y expansions; no es retrocompatible con los formatos de la versión 1.1) Para obtener más información sobre cómo migrar del formato Standard v1.1 al formato X API v2, visita nuestraGuía de migración de formatos de datos.
Orden de los resultados	Cronológico inverso	Cronológico inverso
Paginación de resultados	N/A debe utilizar la navegación por id de Post	Los resultados pueden revisarse hacia adelante o hacia atrás usando un pagination_token_token
Requiere usar credenciales de unaApp de desarrolladorasociado conProyectos		✔

Cronología de Posts del usuario

Las siguientes tablas comparan los endpoints de la cronología de Posts del usuario en la versión estándar v1.1 y en X API v2:

Descripción	Versión estándar v1.1	X API v2
Documentación	Referencia de API	Referencia de la API
Métodos HTTP compatibles	GET	GET
Dominio de alojamiento	https://api.x.com	https://api.x.com
Rutas de endpoints	/1.1/statuses/user_timeline.json	/2/users/:id/tweets
Parámetros requeridos	usuario_id o pantalla_nombre	id de usuario establecido como parámetro de ruta :id
Autenticación	Contexto de usuario de OAuth 1.0a OAuth 2.0 solo para App	Contexto de usuario de OAuth 1.0a OAuth 2.0 Solo App Código de autorización de OAuth 2.0 con PKCE
Límites de tasa de solicitudes/Límites de volumen	900 solicitudes por 15 min con Contexto de usuario de OAuth 1.0a 1500 solicitudes por 15 min con OAuth 2.0 solo con App Límite de solicitudes: 100.000 en un período de 24 horas.	900 solicitudes por ventana de 15 minutos con Contexto de usuario de OAuth 1.0a 1500 solicitudes por ventana de 15 minutos con OAuth 2.0 solo para App Límite de Post: 500,000 con el acceso Essential 2 millones cuando se utiliza el acceso Elevated 10 millones al usar el acceso de Academic Research
Publicaciones predeterminadas por respuesta	15	10
Máximo de Posts por respuesta	200	100
Publicaciones históricas disponibles	Los 3.200 Posts más recientes, incluidos los Retweets	Las 3.200 publicaciones más recientes, incluidos los Retweets
Opciones de navegación del timeline	desde_since_id (exclusivo) usado para sondear actualizaciones máximo_id (inclusive)	comenzar_hora final_tiempo desde_id (exclusivo) usado para sondear actualizaciones hasta_id (exclusiva)
Parámetros opcionales para afinar los resultados	recuento excluir_respuestas incluir_RTs truncar_usuario Tweet_modo desde_id máx._id	máx._resultados exclude(retweets,replies) tweet.fields user.fields place.fields media.fields poll.fields expansions iniciar_hora final_hora desde_id hasta_id
Permite solicitar y recibiranotaciones	N/D	Devuelve resultados de Post con datos de anotación inferidos a partir del texto del Post, como’Género musical’y’Música folk’o’Músico’y’Dolly Parton’
Permite solicitar y recibir una Publicación específicaMétricas	N/D	Devuelve resultados de Post con la información pública disponible_métricas por Post, incluidas las de retweet_recuento, respuesta_recuento, cita_recuento y Me gusta_recuento. Disponible con el contexto de usuario de OAuth 1.0a: Información adicional no_público_métricas, incluidas las impresiones_conteo, usuario_perfil_clics, URL_vínculo_clics. Métricas adicionales de medios, como vistas_métricas de conteo y de reproducción de video. Orgánico adicional_métricas y promociones_Métricas disponibles con Contexto de usuario de OAuth 1.0a para Posts promocionados.
Admite solicitar y recibirid de la conversación	N/D	Devuelve una conversación_campo conversation_id en el que el valor representa el primer Post publicado en un hilo de respuestas para ayudarle a rastrear las conversaciones.
Formato JSON de Post	Formato de datos estándar v1.1	X API v2formato (determinado por los parámetros de solicitud fields y expansions, no retrocompatible con los formatos de v1.1) Para obtener más información sobre cómo migrar del formato Standard v1.1 al formato X API v2, visite nuestraGuía de migración de formatos de datos.
Orden de los resultados	Cronológico inverso	Anticronológico
Paginación de resultados	N/D: debe usar la navegación por id de Post	Los resultados pueden revisarse avanzando o retrocediendo mediante un pagination_token_token
Requiere el uso de credenciales deApp para desarrolladoresasociado con un(a)Proyectos		✔
Proporciona el historial de edición de Post	✔	✔

 

Cronología de menciones de usuario

Las siguientes tablas comparan los endpoints de la cronología de menciones de usuario estándar de v1.1 y de 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 del endpoint	/1.1/statuses/mentions_timeline.json	/2/users/:id/mentions
Parámetros obligatorios	no hay parámetros obligatorios	User ID establecido como parámetro de ruta :id
Autenticación	Contexto de usuario de OAuth 1.0a	Contexto de usuario de OAuth 1.0a OAuth 2.0 App-Only Código de autorización de OAuth 2.0 con PKCE
Límites predeterminados de la tasa de solicitudes	75 solicitudes por 15 min con Contexto de usuario de OAuth 1.0a Límite de 100.000 solicitudes en un período de 24 horas.	180 solicitudes por ventana de 15 minutos con Contexto de usuario de OAuth 1.0a 450 solicitudes por ventana de 15 minutos con OAuth 2.0 App-Only Límite de Posts: 500.000 cuando se usa acceso Essential 2 millones cuando se usa acceso Elevated 10 millones cuando se usa acceso Academic Research
Posts predeterminados por respuesta	15	10
Máximo de Posts por respuesta	200	100
Posts históricos disponibles	Los 800 Posts más recientes	Los 800 Posts más recientes
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) 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/D	Devuelve resultados de Posts con datos de anotación inferidos a partir del texto del Post, como “Music Genre” y “Folk Music” o “Musician” y “Dolly Parton”
Admite solicitar y recibir métricas específicas del Post	N/D	Devuelve resultados de Post con public_metrics disponibles por Post, incluyendo retweet_count, reply_count, quote_count y like_count. Disponible con Contexto de usuario de OAuth 1.0a: non_public_metrics adicionales, incluyendo impression_count, user_profile_clicks, url_link_clicks.  Métricas de medios adicionales como view_count y métricas de reproducción de video. organic_metrics y promoted_metrics adicionales disponibles con Contexto de usuario de OAuth 1.0a para Posts promocionados
Admite solicitar y recibir conversation_id	N/D	Devuelve un campo conversation_id cuyo valor representa el primer Post publicado en un hilo de respuestas para ayudarte a seguir conversaciones.
Formato JSON del Post	Formato de datos Standard v1.1	Formato de X API v2 (determinado por los parámetros de solicitud fields y expansions; no es compatible con los formatos de 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	Inverso cronológico	Inverso cronológico
Parámetros de solicitud para paginación	N/D; se debe usar la navegación por id de Post	Los resultados se pueden revisar avanzando o retrocediendo usando pagination_token
Requiere el uso de credenciales de una App de desarrollador asociada con un Project		✔
Proporciona historial de edición del Post	✔	✔

Otros recursos de migración

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

Centro de migración de X API