Autenticação
Requisitos por endpoint
Métricas privadas
Para acessar métricas privadas, você deve autenticar em nome do autor do Post:Fields e expansions
Por padrão, as respostas incluem apenasid, 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
- Faça a requisição inicial com
max_results - Obtenha
next_tokendo objetometa - Inclua
pagination_tokenna próxima requisição - Repita até que nenhum
next_tokenseja 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
Métricas não públicas e paginação
Métricas não públicas e paginação
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_resultsde pelo menos 10
Métricas promovidas para Posts não promovidos
Métricas promovidas para Posts não promovidos
Solicitar métricas promovidas para Posts que não foram promovidos retorna uma resposta vazia. Este é um problema conhecido.
Texto de Retweet truncado
Texto de Retweet truncado
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