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 una matriz de IDs de todos los Posts de su historial. Para los Posts sin historial de ediciones, esta matriz contendrá un único ID. Para los Posts que han sido editados, esta matriz contiene varios IDs, ordenados de forma ascendente según la secuencia de ediciones, con la versión más reciente en la última posición de la matriz. 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. Como estás realizando solicitudes en nombre de un usuario, debes autenticar estos endpoints mediante un OAuth 2.0 Authorization Code Flow with PKCE o Contexto de usuario de OAuth 1.0a. Este endpoint tiene un límite de tasa por usuario de 180 solicitudes por 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 de un usuario

El endpoint de la cronología de Posts de un usuario proporciona acceso a los Posts publicados por una cuenta específica de X. Recuperar los Posts de un usuario te permite crear experiencias como mostrar una cronología en una interfaz de usuario, 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 te da acceso a los Posts, Retweets, respuestas y Quote Tweets más recientes de una sola cuenta de X, similar a lo que puede verse en la cronología del perfil de un usuario. Aquí tienes una cronología de usuario para @XDevelopers: El endpoint de la cronología de Posts de un 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 conjuntos grandes de Posts. Los ID de Post de los Posts más nuevos y más antiguos incluidos en la página dada también se proporcionan como metadatos, lo que también puede utilizarse para sondear cronologías en busca de Posts recientes. La cronología de Posts de un usuario también admite la posibilidad de especificar los parámetros start_time y end_time para recibir Posts creados dentro de una determinada ventana de tiempo. El endpoint de la cronología de Posts de un 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ás autorizar tu solicitud 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. Debes usar OAuth 1.0a User Context o OAuth 2.0 Authorization Code with 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 Posts de un usuario está diseñado para admitir dos patrones de uso comunes:
  • “Obtener los Posts históricos de un usuario”: Solicitudes realizadas a la cronología de Posts de un usuario para recibir los Posts publicados por el usuario de interés en orden cronológico a lo largo de un periodo reciente específico. El periodo puede establecerse usando 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 el usuario solo ha publicado 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 a la cronología de Posts de un usuario de forma continua para recuperar nuevos Posts publicados por un usuario específico. El último ID de Post recibido puede establecerse como parámetro para cualquier nueva solicitud desde el último Post.

​
Cronología de menciones de usuario

El endpoint de cronología de menciones de usuario le permite solicitar Posts que mencionen a un usuario específico de X; por ejemplo, si una cuenta de X mencionó a @XDevelopers en un Post. Esto también incluirá las respuestas a los Posts del usuario solicitado. Recuperar las menciones de un usuario le permite crear experiencias como descubrir rápidamente quién responde 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 le 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 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 los IDs de Post de los Posts más nuevo y más antiguo incluidos en la página como metadata, que pueden usarse para sondear cronologías en busca de Posts recientes o para navegar por la cronología, de forma similar al endpoint de v1.1 mentions_timeline. El endpoint también admite especificar los parámetros start_time y end_time para recibir Posts creados dentro de una determinada ventana de tiempo.  Para realizar correctamente una solicitud a este endpoint, deberá autorizar su solicitud con los métodos de autenticación Contexto de usuario de OAuth 1.0a, Código de autorización de OAuth 2.0 con PKCE o OAuth 2.0 App-Only. Debe usar Contexto de usuario de OAuth 1.0a o Código de autorización de OAuth 2.0 con PKCE cuando solicite metrics no públicas, metrics promocionadas o la cronología de un usuario protegido. El endpoint de 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á:Obtenga más información sobre cómo acceder a los endpoints de X API v2 en nuestra guía de introducción.
Recursos de apoyo Aprenda a usar Postman para realizar solicitudes Solucionar un error [Visite la página de referencia de la API para este endpoint]((/x-api/posts/tweets-lookup#curl-requests “Visite la página de referencia de la API para este endpoint”)
⌘I