Saltar al contenido principal
Estos tres endpoints de cronologías admiten Posts editados. Estos endpoints siempre devolverán la edición más reciente, junto con el historial de ediciones. Cualquier Post obtenido después de su ventana de edición de 30 minutos representará su versión final. Los metadatos de edición incluyen un arreglo de id de todos los Posts en su historial. Para los Posts sin historial de edición, este arreglo contendrá un único id. Para los Posts que han sido editados, este arreglo contiene varios id, ordenados de forma ascendente que reflejan el orden de las ediciones, con la versión más reciente en la última posición del arreglo. Para obtener más información sobre cómo funcionan las ediciones de Posts, consulta la página Fundamentos de edición de Posts.

​
Cronología de inicio en orden inverso

Este endpoint te permite obtener los Posts, Retweets y respuestas más recientes publicados por el usuario autenticado y por las cuentas que sigue. Dado que realizas solicitudes en nombre de un usuario, debes autenticar estos endpoints usando un flujo de código de autorización de OAuth 2.0 con PKCE o Contexto de usuario de OAuth 1.0a. Este endpoint tiene un límite de 180 solicitudes por usuario en una ventana de 15 minutos. Este endpoint puede devolver todos los Posts creados en una cronología durante los últimos 7 días, así como los 800 más recientes, independientemente de la fecha de creación.

​
Cronología de Posts del usuario

El endpoint de cronología de Posts del usuario proporciona acceso a los Posts publicados por una cuenta específica de X. Recuperar los Posts de un usuario le permite crear experiencias como mostrar una cronología en una interfaz, analizar los Posts de un usuario para comprender mejor su contenido o crear flujos de trabajo de interacción con sus Posts de forma programática. Este endpoint le brinda acceso a los Posts, Retweets, respuestas y Quote Tweets más recientes de una única cuenta de X, similar a lo que se ve en la cronología del perfil de un usuario. Esta es una cronología de usuario para @XDevelopers: El endpoint de cronología de Posts del usuario es un endpoint REST que recibe un único parámetro de ruta para indicar el usuario deseado (por id de usuario). El endpoint puede devolver los 3,200 Posts, Retweets, respuestas y Quote Tweets más recientes publicados por el usuario. Los Posts se entregan en orden cronológico inverso, comenzando por el más reciente. Los resultados están paginados hasta 100 Posts por página. Se proporcionan tokens de paginación para recorrer grandes conjuntos de Posts. Los id de Post del Post más reciente y del más antiguo incluidos en la página también se proporcionan como metadatos, lo que puede utilizarse para sondear cronologías en busca de Posts recientes. La cronología de Posts del usuario también admite especificar los parámetros start_time y end_time para recibir Posts creados dentro de una ventana de tiempo determinada. El endpoint de cronología de Posts del usuario admite los parámetros fields y expansions, y devuelve el nuevo formato de datos JSON. Para realizar correctamente una solicitud a este endpoint, deberá autorizarla con los métodos de autenticación OAuth 1.0a User Context, OAuth 2.0 Authorization Code with PKCE o OAuth 2.0 App-Only. Debe usar OAuth 1.0a User Context o OAuth 2.0 Authorization Code with PKCE cuando solicite métricas no públicas, métricas promocionadas o la cronología de un usuario protegido. El endpoint de cronología de Posts del usuario está diseñado para admitir dos patrones de uso comunes:
  • “Obtener los Posts históricos de un usuario”: Solicitudes realizadas al endpoint de cronología de Posts del usuario para recibir los Posts creados por el usuario de interés en orden cronológico dentro de un período reciente específico. El período puede establecerse utilizando start_time y end_time y paginando por todos los resultados. En algunos casos, se puede recuperar todo el historial de Posts de un usuario si solo ha creado hasta 3,200 Posts en su cuenta. Los Posts incluidos dependerán de su disponibilidad pública y de la autenticación utilizada para las solicitudes.
  • “Sondeo de nuevos Posts”: Solicitudes realizadas al endpoint de cronología de Posts del usuario de forma continua, para recuperar nuevos Posts creados por un usuario específico. El último id de Post recibido puede establecerse como parámetro para cualquier solicitud nueva desde el último Post.

​
Cronología de menciones de usuario

El endpoint de la cronología de menciones de usuario te permite solicitar Posts que mencionan a un usuario específico de X; por ejemplo, si una cuenta de X mencionó a @XDevelopers en un Post. Esto también incluirá respuestas a los Posts del usuario solicitado. Recuperar las menciones de un usuario te permite crear experiencias como descubrir rápidamente quién está respondiendo a los Posts de un usuario, quién lo menciona o crear flujos de trabajo de interacción con sus Posts de forma programática. El endpoint te permite solicitar las menciones y respuestas más recientes de un único usuario, similar a lo que puede verse en las notificaciones de menciones de un usuario en X. La cronología de menciones de usuario es un endpoint REST que recibe un único parámetro de ruta para indicar el usuario deseado (por id de usuario). El endpoint puede devolver hasta 800 de las menciones más recientes de ese usuario. Los Posts se entregan en orden cronológico inverso, comenzando por el más reciente. Los resultados están paginados con hasta 100 Posts por página. Se proporcionan tokens de paginación para recorrer conjuntos grandes de Posts. También se proporcionan como metadatos los IDs del Post más nuevo y del más antiguo incluidos en la página dada, lo que puede usarse para sondear cronologías en busca de Posts recientes o para navegar por la cronología de forma similar al endpoint v1.1 mentions_timeline. El endpoint también permite especificar los parámetros start_time y end_time para recibir Posts creados dentro de una ventana de tiempo determinada.  Para realizar correctamente una solicitud a este endpoint, deberás autorizarla con los métodos de Autenticación OAuth 1.0a User Context, Código de autorización de OAuth 2.0 con PKCE o OAuth 2.0 App-Only. Debes usar OAuth 1.0a User Context o Código de autorización de OAuth 2.0 con PKCE cuando solicites métricas no públicas, métricas promocionadas o la cronología de un usuario protegido. El endpoint de la cronología de menciones de usuario admite los parámetros fields y expansions, y devuelve el nuevo formato de datos JSON.
Configuración de la cuentaPara acceder a estos endpoints, necesitarás:Obtén más información sobre cómo acceder a los endpoints de X API v2 en nuestra guía de introducción.
Recursos de ayuda Aprende a usar Postman para realizar solicitudes Soluciona un error Visita la página de referencia del API para este endpoint