Skip to main content
Esta guía cubre los conceptos clave que necesitas para integrar los endpoints de Timelines en tu aplicación.

Autenticación

Requisitos del endpoint

Métricas privadas

Para acceder a métricas privadas, debes autenticarte en nombre del autor del Post:
Estos campos requieren autenticación User Context:
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

Fields y expansions

Por defecto, las respuestas incluyen solo id, text y edit_history_tweet_ids. Solicita datos adicionales:

Ejemplo de solicitud

cURL

Fields clave

Guía de fields y expansions

Aprende más sobre cómo personalizar las respuestas

Paginación

Los timelines devuelven hasta 100 Posts por solicitud. Usa la paginación para conjuntos de resultados más grandes.

Cómo funciona

  1. Haz la solicitud inicial con max_results
  2. Obtén el next_token del objeto meta
  3. Incluye pagination_token en la siguiente solicitud
  4. Repite hasta que no se devuelva ningún next_token

Ejemplo

cURL

Guía de paginación

Aprende más sobre paginación

Filtrar resultados

Filtrado basado en tiempo

Parámetro exclude

Elimina tipos específicos de Post de los resultados:
cURL

Límites de volumen

Cada timeline tiene límites máximos de recuperación:
Solicitar Posts más allá de estos límites devuelve una respuesta exitosa sin datos.

Ediciones de Post

Los Posts pueden editarse hasta 5 veces dentro de los 30 minutos. Los endpoints de timeline siempre devuelven la versión más reciente.

Consideraciones

  • Los Posts anteriores a 30 minutos representan su versión final
  • Los casos de uso casi en tiempo real deben tener en cuenta posibles ediciones
  • Usa Post lookup para verificar el estado final si es necesario

Fundamentos de edición de Post

Aprende más sobre las ediciones de Post

Métricas de Post

Métricas públicas

Disponibles para todos los Posts con autenticación App-Only o User Context:

Métricas privadas

Requiere autenticación User Context del autor del Post:
  • Solo disponible para Posts de los últimos 30 días
  • Solo se devuelve para Posts creados por el usuario autenticado
  • Devuelve error para los Posts de otros usuarios

Casos extremos

Al solicitar métricas no públicas para Posts de más de 30 días, puedes recibir un next_token con result_count: 0. Para evitar esto:
  • Mantén las solicitudes dentro de los últimos 30 días
  • Usa un max_results de al menos 10
Solicitar métricas promocionadas para Posts que no fueron promocionados devuelve una respuesta vacía. Este es un problema conocido.
Para los Retweets con texto de más de 140 caracteres, el campo text se trunca. Usa la expansion referenced_tweets.id para obtener el texto completo.

Próximos pasos

Quickstart del home timeline

Obtén el home feed de un usuario

Quickstart de menciones

Obtén las menciones de un usuario

Referencia de la API

Documentación completa del endpoint

Paginación

Maneja conjuntos de resultados grandes