Skip to main content
Este guia cobre os conceitos-chave que você precisa para integrar os endpoints de Timelines à sua aplicação.

Autenticação

Requisitos por endpoint

Métricas privadas

Para acessar métricas privadas, você deve autenticar em nome do autor do Post:
Estes fields exigem autenticação 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 e expansions

Por padrão, as respostas incluem apenas id, text e edit_history_tweet_ids. Solicite dados adicionais:

Exemplo de requisição

cURL

Fields principais

Guia de fields e expansions

Saiba mais sobre como personalizar respostas

Paginação

Timelines retornam até 100 Posts por requisição. Use paginação para conjuntos de resultados maiores.

Como funciona

  1. Faça a requisição inicial com max_results
  2. Obtenha next_token do objeto meta
  3. Inclua pagination_token na próxima requisição
  4. Repita até que nenhum next_token seja retornado

Exemplo

cURL

Guia de paginação

Saiba mais sobre paginação

Filtragem de resultados

Filtragem baseada em tempo

Parâmetro exclude

Remova tipos específicos de Post dos resultados:
cURL

Limites de volume

Cada timeline tem limites máximos de recuperação:
Solicitar Posts além desses limites retorna uma resposta bem-sucedida sem dados.

Edições de Post

Posts podem ser editados até 5 vezes dentro de 30 minutos. Os endpoints de timeline sempre retornam a versão mais recente.

Considerações

  • Posts com mais de 30 minutos representam sua versão final
  • Casos de uso em quase tempo real devem considerar edições potenciais
  • Use o Post lookup para verificar o estado final se necessário

Fundamentos de edição de Posts

Saiba mais sobre edições de Post

Métricas de Post

Métricas públicas

Disponíveis para todos os Posts com autenticação App-Only ou User Context:

Métricas privadas

Requer autenticação User Context do autor do Post:
  • Disponível apenas para Posts dos últimos 30 dias
  • Retornado apenas para Posts criados pelo usuário autenticado
  • Retorna erro para Posts de outros usuários

Casos de borda

Ao solicitar métricas não públicas para Posts com mais de 30 dias, você pode receber um next_token com result_count: 0. Para evitar isso:
  • Mantenha as requisições dentro dos últimos 30 dias
  • Use max_results de pelo menos 10
Solicitar métricas promovidas para Posts que não foram promovidos retorna uma resposta vazia. Este é um problema conhecido.
Para Retweets com texto acima de 140 caracteres, o field text é truncado. Use a expansion referenced_tweets.id para obter o texto completo.

Próximos passos

Quickstart de home timeline

Obtenha o feed principal de um usuário

Quickstart de menções

Obtenha menções de um usuário

Referência da API

Documentação completa do endpoint

Paginação

Lide com grandes conjuntos de resultados