Pular para o conteúdo principal
Esses três endpoints de timelines oferecem suporte a Posts editados. Esses endpoints sempre retornarão a edição mais recente, juntamente com o histórico de edições. Qualquer Post coletado após sua janela de edição de 30 minutos representará sua versão final. Os metadados de edição incluem um array de IDs de todos os Posts em seu histórico. Para Posts sem histórico de edição, esse array conterá um único ID. Para Posts que foram editados, esse array contém vários IDs, organizados em ordem crescente que reflete a sequência das edições, com a versão mais recente na última posição do array. Para saber mais sobre como as edições de Post funcionam, consulte a página Noções básicas sobre edição de Posts.

​
Linha do tempo inicial em ordem inversa

Este endpoint permite recuperar os Posts, Retweets e respostas mais recentes publicados pelo usuário autenticado e pelas contas que ele segue. Como as solicitações são feitas em nome de um usuário, é necessário autenticar esses endpoints usando o OAuth 2.0 Authorization Code Flow with PKCE ou o Contexto de Usuário do OAuth 1.0a. Este endpoint tem um limite de taxa por usuário de 180 solicitações por janela de 15 minutos. Ele pode retornar todos os Posts criados em uma linha do tempo nos últimos 7 dias, bem como os 800 mais recentes, independentemente da data de criação.

​
Timeline de Posts do usuário

O endpoint de timeline de Posts do usuário fornece acesso aos Posts publicados por uma conta específica do X. Recuperar os Posts de um usuário permite criar experiências como exibir uma timeline em uma interface do usuário, analisar os Posts de um usuário para entender melhor seu conteúdo ou criar fluxos de engajamento com seus Posts de forma programática. Este endpoint dá acesso aos Posts, Retweets, respostas e Quote Tweets mais recentes de uma única conta do X, similar ao que pode ser visto na timeline do perfil de um usuário. Aqui está uma timeline de usuário para @XDevelopers: O endpoint de timeline de Posts do usuário é um endpoint REST que recebe um único parâmetro de caminho para indicar o usuário desejado (pelo ID do usuário). O endpoint pode retornar os 3.200 Posts, Retweets, respostas e Quote Tweets mais recentes publicados pelo usuário. Os Posts são entregues em ordem cronológica inversa, começando pelo mais recente. Os resultados são paginados em até 100 Posts por página. Tokens de paginação são fornecidos para percorrer grandes conjuntos de Posts. Os IDs do Post mais novo e do mais antigo incluídos na página em questão também são fornecidos como metadata, o que também pode ser usado para fazer polling de timelines em busca de Posts recentes. A timeline de Posts do usuário também oferece suporte à especificação dos parâmetros start_time e end_time para receber Posts criados dentro de uma determinada janela de tempo.  O endpoint de timeline de Posts do usuário oferece suporte aos parâmetros fields e expansions e retorna o novo formato de dados JSON. Para realizar uma solicitação com sucesso a este endpoint, você precisará autorizar sua solicitação com os métodos de autenticação Contexto de Usuário do OAuth 1.0a, OAuth 2.0 Authorization Code com PKCE ou OAuth 2.0 App-Only. Você deve usar Contexto de Usuário do OAuth 1.0a ou OAuth 2.0 Authorization Code com PKCE ao solicitar métricas não públicas, métricas promovidas ou a timeline de um usuário protegido.  O endpoint de timeline de Posts do usuário foi projetado para dar suporte a dois padrões de uso comuns: 
  • “Obter os Posts históricos de um usuário”: solicitações feitas à timeline de Posts do usuário para receber Posts autorados pelo usuário de interesse em ordem cronológica ao longo de um período recente específico. O período pode ser definido usando start_time e end_time e paginando por todos os resultados. Em alguns casos, todo o histórico de Posts de um usuário pode ser recuperado se o usuário tiver autorado apenas até 3.200 Posts em sua conta. Os Posts incluídos dependerão da disponibilidade pública e da autenticação usada para as solicitações.
  • “Fazer polling de novos Posts”: solicitações feitas à timeline de Posts do usuário de forma contínua para recuperar novos Posts autorados por um usuário específico. O último ID do Post recebido pode ser definido como um parâmetro para quaisquer novas solicitações desde o último Post.

​
Linha do tempo de menções do usuário

O endpoint de linha do tempo de menções do usuário permite solicitar Posts que mencionam um usuário específico do X, por exemplo, quando uma conta do X menciona @XDevelopers em um Post. Ele também inclui respostas aos Posts do usuário indicado. Recuperar as menções de um usuário permite criar experiências como descobrir rapidamente quem está respondendo aos Posts desse usuário, quem o está mencionando ou criar fluxos de trabalho de engajamento com seus Posts de forma programática. O endpoint permite solicitar as menções e respostas mais recentes de um único usuário, semelhante ao que pode ser visto nas notificações de menções desse usuário no X. A linha do tempo de menções do usuário é um endpoint REST que recebe um único parâmetro de caminho para indicar o usuário desejado (por ID de usuário). O endpoint pode retornar até 800 menções mais recentes desse usuário. Os Posts são entregues em ordem cronológica inversa, começando pelo mais recente. Os resultados são paginados em até 100 Posts por página. Tokens de paginação são fornecidos para percorrer conjuntos grandes de Posts. Os IDs de Post dos Posts mais novo e mais antigo incluídos na página em questão também são fornecidos como metadata, o que pode ser usado para consultar linhas do tempo em busca de Posts recentes ou para navegar pela linha do tempo de forma semelhante ao endpoint v1.1 mentions_timeline. O endpoint também permite especificar os parâmetros start_time e end_time para receber Posts criados dentro de uma determinada janela de tempo. Para fazer uma solicitação bem-sucedida a este endpoint, você precisará autorizar sua requisição com os métodos de autenticação Contexto de Usuário do OAuth 1.0a, OAuth 2.0 Authorization Code com PKCE ou OAuth 2.0 App-Only. Você deve usar Contexto de Usuário do OAuth 1.0a ou OAuth 2.0 Authorization Code com PKCE ao solicitar métricas não públicas, métricas promovidas ou a linha do tempo de um usuário protegido. O endpoint de linha do tempo de menções do usuário oferece suporte aos parâmetros fields e expansions e retorna o novo formato de dados JSON.
Configuração da contaPara acessar esses endpoints, você precisará de:Saiba mais sobre como obter acesso aos endpoints da X API v2 em nosso guia de primeiros passos.
Recursos de suporte Aprenda a usar o Postman para fazer solicitações Solucionar um erro Visite a página de referência da API para este endpoint
⌘I