> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Explore os Posts e menções de um usuário com a X API v2

> Os endpoints de user Post timeline e user mention timeline permitem que os desenvolvedores obtenham os Posts públicos criados por um usuário ou que mencionam um usuário.

## Introdução

Enquanto o [endpoint de recent search](/x-api/posts/search/introduction) 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

* Para usar os endpoints de user Tweet timeline e user mention timeline, você precisará de uma conta de desenvolvedor válida.
* Você também precisará de um [Project](/resources/fundamentals/developer-apps) criado.
* Você deve ter [se inscrito](https://developer.x.com/en/portal/petition/essential/basic-info) para uma conta de desenvolvedor e ter ativado a [nova experiência do Developer Console](https://developer.x.com/en/portal/opt-in.html).
* O acesso está disponível com chaves e tokens ativos para um App de desenvolvedor conectado a um [Project](/resources/fundamentals/developer-apps) criado no [Developer Console](/resources/fundamentals/developer-portal).
* Um Bearer Token do seu App no [X Developer Console](/resources/fundamentals/developer-portal).
* Se você não tem uma conta de desenvolvedor aprovada, pode [solicitar uma](https://developer.x.com/en/apply-for-access).

## Conta de desenvolvedor aprovada

Se você ainda não tem uma, pode [solicitar uma](https://developer.x.com/en/apply-for-access).

## Crie um Project e conecte um App

No [Developer Console](https://developer.x.com/en/portal/dashboard), clique em criar um novo App.

<Frame>
  <img src="https://mintcdn.com/x-preview/l3xgUBEfGdfuOen0/images/projects.png.twimg.1920.png?fit=max&auto=format&n=l3xgUBEfGdfuOen0&q=85&s=9264e7d6cb9aa2dbeeaabbd836302d74" width="880" height="397" data-path="images/projects.png.twimg.1920.png" />
</Frame>

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](/resources/fundamentals/developer-apps) existente (um App é um contêiner para suas chaves de API que você precisa para fazer uma requisição HTTP à X API).

<Frame>
  <img src="https://mintcdn.com/x-preview/s_D1jGy1nLdDmXkd/images/add-your-app.png.twimg.1920.png?fit=max&auto=format&n=s_D1jGy1nLdDmXkd&q=85&s=c659b4cfe02d956faad3021a7beb2c9d" width="880" height="569" data-path="images/add-your-app.png.twimg.1920.png" />
</Frame>

Clique em 'create a new App instead' e dê um nome ao seu App para criar um novo App.

<Frame>
  <img src="https://mintcdn.com/x-preview/l3xgUBEfGdfuOen0/images/last-step-name-your-app.png.twimg.1920.png?fit=max&auto=format&n=l3xgUBEfGdfuOen0&q=85&s=c62db12722d6c1048d2522c76498a9db" width="880" height="558" data-path="images/last-step-name-your-app.png.twimg.1920.png" />
</Frame>

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.

<Frame>
  <img src="https://mintcdn.com/x-preview/l3xgUBEfGdfuOen0/images/here-are-your-keys.png.twimg.1920.png?fit=max&auto=format&n=l3xgUBEfGdfuOen0&q=85&s=7c7385eed29546412c31c659ef6490c4" width="880" height="897" data-path="images/here-are-your-keys.png.twimg.1920.png" />
</Frame>

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](/x-api/users/lookup/quickstart/user-lookup). Substitua USER\_NAME pelo username de sua escolha e XXXX pelo seu próprio bearer token obtido acima

```bash theme={null}
  curl --request GET 'https://api.x.com/2/users/by/username/USER_NAME --header 'Authorization: Bearer XXXXXX'
```

Você verá o user ID na resposta como mostrado abaixo:

```json theme={null}
{
   "data": {
       "id": "2244994945",
       "name": "Developers",
       "username": "XDevelopers"
   }
}
```

## 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)

```bash theme={null}
curl --request GET 'https://api.x.com/2/users/USER_ID/tweets' --header 'Authorization: Bearer XXXXXX'
```

Você verá que a resposta JSON dessas requisições contém o ID e o texto dos Posts por padrão (exemplo abaixo).

```yaml theme={null}
{
   "id": "1334200897081987072",
   "text": "👀 If you are new to the X API v2, check out this step-by-step guide to making your first request https://t.co/4rZqThpSbp"
}
```

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](/x-api/fundamentals/data-dictionary/reference#how-to-use-fields-and-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](https://github.com/xdevplatform/Twitter-API-v2-sample-code).

## 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:

```bash theme={null}
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 presentes nas menções. Aqui está um exemplo:

```json theme={null}
{
   "domain": {
       "id": "47",
       "name": "Brand",
       "description": "Brands and Companies"
   },
   "entity": {
       "id": "783214",
       "name": "X"
   }
}
```

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

```bash theme={null}
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á o preview\_image\_url no objeto includes como mostrado abaixo:

```json theme={null}
{
   "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 os Posts. Abaixo estão alguns recursos para ter à mão ao usar os endpoints user Tweet timeline e user mention timeline.

## Recursos

* Saiba mais sobre os [endpoints user Tweet timeline e user mention timeline](/x-api/posts/timelines/introduction).
* Consulte a [referência da API para o endpoint user Tweet timeline](/x-api/users/get-posts) para saber mais sobre o que está disponível.
* Consulte a [referência da API para o endpoint user mention timeline](/x-api/users/get-mentions) para saber mais sobre o que está disponível.
* Inspire-se lendo nossos outros [tutoriais](/tutorials).