Autenticación
Requisitos del endpoint
Métricas privadas
Para acceder a métricas privadas, debes autenticarte en nombre del autor del Post:Fields y expansions
Por defecto, las respuestas incluyen soloid, 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
- Haz la solicitud inicial con
max_results - Obtén el
next_tokendel objetometa - Incluye
pagination_tokenen la siguiente solicitud - 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
Métricas no públicas y paginación
Métricas no públicas y paginación
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_resultsde al menos 10
Métricas promocionadas para Posts no promocionados
Métricas promocionadas para Posts no promocionados
Solicitar métricas promocionadas para Posts que no fueron promocionados devuelve una respuesta vacía. Este es un problema conocido.
Texto truncado de Retweet
Texto truncado de Retweet
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