Skip to main content

Introdução

Enquanto o endpoint de recent search permite que você obtenha apenas Posts publicados nos últimos 7 dias, os endpoints de user Post timeline e user mention timeline permitem obter Posts e menções mais antigos que os últimos 7 dias, para um usuário autorizado (usando o user ID). Os desenvolvedores podem usar esses endpoints para estudar tópicos, entidades e sentimento dos Posts da timeline de um usuário ou das menções. Neste tutorial, mostraremos como explorar os Posts e menções de um usuário usando os endpoints de user Tweet timeline e user mention timeline.

Pré-requisitos

Conta de desenvolvedor aprovada

Se você ainda não tem uma, pode solicitar uma.

Crie um Project e conecte um App

No Developer Console, clique em criar um novo App.
Dê a ele um nome, selecione o caso de uso apropriado e forneça uma descrição do Project. Em seguida, você pode criar um novo App ou conectar um App existente (um App é um contêiner para suas chaves de API que você precisa para fazer uma requisição HTTP à X API).
Clique em ‘create a new App instead’ e dê um nome ao seu App para criar um novo App.
Depois de clicar em concluir, você receberá suas chaves de API e o bearer token que poderá usar para se conectar aos novos endpoints da X API v2.
Clique no (+) ao lado da API key, API secret key e Bearer token e copie esses valores para um lugar seguro em sua máquina local. Você precisará deles para fazer as chamadas de API no próximo passo. Observação: As chaves na captura de tela acima estão ocultas, mas no seu próprio Developer Console, você poderá ver os valores reais da API key, API secret key e Bearer token.

Como obter o user ID de um usuário para usar nos endpoints user Tweet timeline e user mention timeline

Os endpoints de user Tweet timeline e user mention timeline permitem obter Posts usando o user ID. Para obter o user ID a partir de um username, você pode usar o novo endpoint user lookup v2. Substitua USER_NAME pelo username de sua escolha e XXXX pelo seu próprio bearer token obtido acima
Você verá o user ID na resposta como mostrado abaixo:

Conectando-se aos endpoints user Tweet timeline e user mention timeline

Para obter a user Tweet timeline de um usuário, execute o seguinte comando curl no seu terminal (certifique-se de substituir USER_ID pelo user ID de sua escolha e XXXX pelo seu próprio bearer token obtido acima)
Você verá que a resposta JSON dessas requisições contém o ID e o texto dos Posts por padrão (exemplo abaixo).
Se você quiser campos adicionais retornados como parte da resposta (como informações do usuário, campos adicionais do Tweet como context annotations, etc.), precisará especificar esses campos explicitamente na sua resposta. Aprenda como fazer isso no guia sobre uso de fields e expansions. Você também pode obter esses Posts usando linguagens de programação de sua escolha. Confira nosso código de exemplo em Python, Node (JavaScript), Java e Ruby para os endpoints user Tweet timeline e user mention timeline no nosso repositório do GitHub.

Explorando os Posts do usuário

Uma vez que saiba como obter Posts usando os endpoints user Tweet timeline e user mention timeline, você pode começar a explorar seus Posts. Por exemplo, se quiser identificar entidades nomeadas comuns presentes nas menções de um usuário, pode fazer o seguinte: Na requisição da API, especifique que deseja o objeto context_annotations retornado nas respostas do Tweet:
Na resposta, você verá se há entidades nomeadas presentes nas menções. Aqui está um exemplo:
Se quisesse ver quais entidades populares aparecem em suas menções, você poderia manter uma contagem das entidades populares analisando cada Tweet nas menções. Se você quiser explorar a URL de imagem de preview de todos os Posts em sua timeline que contêm mídia, pode fazer o seguinte: Na requisição da API, especifique que deseja o preview_image_url nos campos tweet.media, e as expansions attachments.media_keys
Na resposta, você verá o preview_image_url no objeto includes como mostrado abaixo:
Depois de entender como navegar pelos Posts de um usuário, você também pode usar outras APIs e serviços para fazer mais com os Posts. Abaixo estão alguns recursos para ter à mão ao usar os endpoints user Tweet timeline e user mention timeline.

Recursos