Pular para o conteúdo principal

​
Introdução

Embora o endpoint de busca recente permita obter apenas Posts publicados nos últimos 7 dias, os endpoints de timeline de Posts do usuário e de timeline de menções do usuário permitem recuperar Posts e menções com mais de 7 dias, para um usuário autorizado (usando o id do usuário). Desenvolvedores podem usar esses endpoints para estudar tópicos, entidades e sentimento dos Posts da timeline de um usuário ou de suas menções. Neste tutorial, mostraremos como explorar os Posts e as menções de um usuário usando os endpoints de timeline de Tweet do usuário e de timeline de menções do usuário.  

​
Pré-requisitos

​
Conta de desenvolvedor aprovada

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

​
Crie um Projeto e conecte um App

No portal do desenvolvedor, clique em criar um novo Projeto.
Dê um nome, selecione o caso de uso apropriado e forneça uma descrição do Projeto. Em seguida, você pode criar um novo App ou conectar um App existente (um App é um contêiner para suas chaves de API, necessárias para fazer uma solicitaçã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 na X API v2.
Clique no (+) ao lado de API Key, API Secret Key e Bearer Token e copie esses valores para um local seguro na sua máquina local. Você precisará deles para fazer as chamadas à API na próxima etapa. Observação: As chaves na captura de tela acima estão ocultas, mas no seu próprio portal do desenvolvedor você poderá ver os valores reais para a API Key, API Secret Key e Bearer Token.  

​
Como obter o id do usuário para usar nos endpoints de timeline de Tweets do usuário e de menções ao usuário

Os endpoints de timeline de Tweets do usuário e de menções ao usuário permitem obter Posts usando o id do usuário. Para obter o id do usuário a partir de um nome de usuário, você pode usar o novo endpoint de consulta de usuário v2. Substitua USER_NAME pelo nome de usuário desejado e XXXX pelo seu próprio Bearer Token obtido acima 
  curl --request GET 'https://api.x.com/2/users/by/username/USER_NAME --header 'Authorization: Bearer XXXXXX'
Você verá o id do usuário na resposta, conforme mostrado abaixo: 
{
   "data": {
       "id": "2244994945",
       "name": "Desenvolvedores",
       "username": "XDevelopers"
   }
}

​
Conectando aos endpoints da linha do tempo de Tweets do usuário e da linha do tempo de menções do usuário

Para obter a linha do tempo de Tweets de um usuário, execute o seguinte comando curl no seu terminal (certifique-se de substituir USER_ID pelo id do usuário desejado e XXXX pelo seu próprio Bearer Token obtido acima) 
curl --request GET 'https://api.x.com/2/users/USER_ID/tweets' --header 'Authorization: Bearer XXXXXX'
Você verá que a resposta JSON dessas solicitações contém, por padrão, o id e o texto dos Posts (veja o exemplo abaixo). 
{
   "id": "1334200897081987072",
   "text": "👀 Se você é novo na X API v2, confira este guia passo a passo para fazer sua primeira requisição https://t.co/4rZqThpSbp"
}
Se você quiser que campos adicionais sejam retornados como parte da resposta (como informações do usuário e campos adicionais de Tweet, como context annotations, etc.), será necessário especificar esses fields explicitamente na sua solicitação. Saiba como fazer isso no guia sobre o uso de fields e expansions. Você também pode obter esses Posts usando a linguagem de programação de sua preferência. Confira nossos exemplos de código em Python, Node (JavaScript), Java e Ruby para os endpoints de user Tweet timeline e user mention timeline em nosso repositório no GitHub.

​
Explorando os Posts do usuário

Depois que você souber como obter Posts usando os endpoints de timeline de Tweets do usuário e de menções ao usuário, poderá começar a explorar os Posts dele. Por exemplo, se quiser identificar entidades nomeadas comuns presentes nas menções de um usuário, você pode fazer o seguinte: Na solicitação à API, especifique que deseja o objeto context_annotations retornado nas respostas de Tweet: 
curl --request GET 'https://api.x.com/2/users/USER_ID/mentions?tweet.fields=context_annotations' --header 'Authorization: Bearer XXXXXX'
Na resposta, você verá se há entidades nomeadas nas menções. Veja um exemplo: 
{
   "domain": {
       "id": "47",
       "name": "Brand",
       "description": "Marcas e Empresas"
   },
   "entity": {
       "id": "783214",
       "name": "X"
   }
}
Se você quiser ver quais entidades populares aparecem nas suas menções, poderá manter uma contagem dessas entidades analisando cada Tweet nas menções. Se você quiser explorar a URL da imagem de prévia de todos os Posts na sua timeline que contêm mídia, pode fazer o seguinte: Na solicitação à API, especifique que deseja o preview_image_url em tweet.media fields e as expansions de attachments.media_keys 
curl --request GET 'https://api.x.com/2/users/2244994945/mentions?max_results=100&media.fields=preview_image_url&expansions=attachments.media_keys' --header 'Authorization: Bearer XXXXXX'
Na resposta, você verá preview_image_url no objeto includes, conforme mostrado abaixo: 
{
   "includes": {
       "media": [
           {
               "media_key": "16_1334657439640121344",
               "preview_image_url": "https://pbs.twimg.com/tweet_video_thumb/EoWn3rqU8AAtFWL.jpg",
               "type": "animated_gif"
           }
       ]
   }
}
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 esses Posts. Abaixo estão alguns recursos úteis ao usar os endpoints de timeline de Tweets do usuário e de timeline de menções do usuário.

​
Recursos

⌘I