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

# Sobre a API do X

> A API do X oferece acesso programático à conversa pública do X. Recupere posts, analise tendências, crie integrações e novas experiências na plataforma.

A API do X oferece acesso programático à conversa pública do X. Recupere posts, analise tendências, crie integrações e desenvolva novas experiências na plataforma.

***

## O que você pode fazer

| Recurso                | Descrição                                                         |
| :--------------------- | :---------------------------------------------------------------- |
| **Ler posts**          | Pesquise, consulte e transmita posts em tempo real                |
| **Publicar conteúdo**  | Crie posts, respostas e threads                                   |
| **Gerenciar usuários** | Consulte usuários e gerencie quem você segue, bloqueia e silencia |
| **Analisar dados**     | Acesse métricas, tendências e análises de engajamento             |
| **Criar integrações**  | Envie DMs, gerencie listas e interaja com Spaces                  |

***

## Versões da API

<Tabs>
  <Tab title="X API v2 (Recommended)">
    A versão atual da API do X, com recursos modernos e preços flexíveis.

    **Por que usar a v2:**

    * Preços de pagamento por uso
    * Formato de resposta JSON moderno
    * [Fields](/x-api/fundamentals/fields) e [expansions](/x-api/fundamentals/expansions) flexíveis
    * Recursos avançados: anotações, rastreamento de conversas, histórico de edições
    * Todos os novos endpoints e recursos

    **Começando:**

    1. Cadastre-se em [console.x.com](https://console.x.com)
    2. Crie um app e obtenha suas credenciais
    3. [Faça sua primeira solicitação](/x-api/getting-started/make-your-first-request)
  </Tab>

  <Tab title="X API v1.1 (Legacy)">
    A versão anterior da API do X. Suporte limitado; use a v2 para novos projetos.

    **Ainda disponível:**

    * Alguns endpoints de upload de mídia
    * Streaming legado (descontinuado)
    * Alguns endpoints especializados

    **Migração para a v2:**
    Consulte o [guia de migração](/x-api/migrate/overview) para mapeamento de endpoints e alterações no formato dos dados.
  </Tab>
</Tabs>

***

## Recursos disponíveis

A API do X oferece acesso aos seguintes tipos de recursos:

<CardGroup cols={3}>
  <Card title="Posts" icon="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/NEh9mjpH7RaTDEed/icons/xds/icon-chat.svg?fit=max&auto=format&n=NEh9mjpH7RaTDEed&q=85&s=d41b5ee3c6e63a9a39acd28c6568d6dc" width="24" height="24" data-path="icons/xds/icon-chat.svg">
    Pesquise, recupere, crie e exclua posts. Acesse linhas do tempo, threads e posts citados.
  </Card>

  <Card title="Usuários" icon="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/VFX2XSyPqtT4SVsH/icons/xds/icon-person.svg?fit=max&auto=format&n=VFX2XSyPqtT4SVsH&q=85&s=d0d289815cdfc8e3c20af259d2f04c46" width="24" height="24" data-path="icons/xds/icon-person.svg">
    Consulte perfis, gerencie relacionamentos e acesse dados de seguidores.
  </Card>

  <Card title="Spaces" icon="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/VFX2XSyPqtT4SVsH/icons/xds/icon-microphone.svg?fit=max&auto=format&n=VFX2XSyPqtT4SVsH&q=85&s=04d1ab715019f2cf6013b1a2ad97dccf" width="24" height="24" data-path="icons/xds/icon-microphone.svg">
    Descubra conversas de áudio ao vivo e seus participantes.
  </Card>

  <Card title="Mensagens diretas" icon="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/Xkd8wjAYBUaNeVZi/icons/xds/icon-envelope.svg?fit=max&auto=format&n=Xkd8wjAYBUaNeVZi&q=85&s=a4e3fdf04c6687542b88aa6c8528830e" width="24" height="24" data-path="icons/xds/icon-envelope.svg">
    Envie e receba mensagens privadas entre usuários.
  </Card>

  <Card title="Listas" icon="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/NEh9mjpH7RaTDEed/icons/xds/icon-bulleted-list.svg?fit=max&auto=format&n=NEh9mjpH7RaTDEed&q=85&s=8751ac17be48cbce7d9750daf2641945" width="24" height="24" data-path="icons/xds/icon-bulleted-list.svg">
    Crie e gerencie listas selecionadas de contas.
  </Card>

  <Card title="Tendências" icon="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/Xkd8wjAYBUaNeVZi/icons/xds/icon-feather-chart-line.svg?fit=max&auto=format&n=Xkd8wjAYBUaNeVZi&q=85&s=eb2233d5c6aa1d3b04d3fefea66c9db4" width="24" height="24" data-path="icons/xds/icon-feather-chart-line.svg">
    Acesse tópicos em alta por localização.
  </Card>
</CardGroup>

***

## Destaques da v2

<Accordion title="Fields e expansions">
  Solicite apenas os dados de que você precisa. Use os parâmetros `fields` para selecionar atributos específicos e `expansions` para incluir objetos relacionados.

  ```bash theme={null}
  curl "https://api.x.com/2/tweets/123?tweet.fields=created_at,public_metrics&expansions=author_id&user.fields=username" \
    -H "Authorization: Bearer $TOKEN"
  ```

  [Saiba mais sobre fields →](/x-api/fundamentals/fields)
</Accordion>

<Accordion title="Anotações de posts">
  Os posts incluem anotações semânticas que identificam pessoas, lugares, produtos e tópicos. Filtre streams e pesquisas por tópico.

  [Saiba mais sobre anotações →](/x-api/fundamentals/post-annotations)
</Accordion>

<Accordion title="Métricas de engajamento">
  Acesse métricas públicas (curtidas, reposts, respostas) e métricas privadas (impressões, cliques) dos seus próprios posts.

  [Saiba mais sobre métricas →](/x-api/fundamentals/metrics)
</Accordion>

<Accordion title="Rastreamento de conversas">
  Reconstrua threads de conversa inteiros usando `conversation_id`. Acompanhe as respostas em todo o thread.

  [Saiba mais sobre rastreamento de conversas →](/x-api/fundamentals/conversation-id)
</Accordion>

<Accordion title="Histórico de edições">
  Acesse o histórico de edições dos posts, incluindo todas as versões anteriores e os metadados de edição.

  [Saiba mais sobre edição de posts →](/x-api/fundamentals/edit-posts)
</Accordion>

***

## Preços

A X API v2 usa o modelo de **pagamento por uso**:

| Benefício                        | Descrição                                                                  |
| :------------------------------- | :------------------------------------------------------------------------- |
| **Sem assinaturas**              | Pague apenas pelo que usar                                                 |
| **Baseado em créditos**          | Compre créditos que são debitados por solicitação                          |
| **Acompanhamento em tempo real** | Monitore o uso no Developer Console                                        |
| **Deduplicação**                 | O mesmo recurso solicitado duas vezes em 24 horas é cobrado apenas uma vez |

[Ver detalhes de preços →](/x-api/getting-started/pricing)

***

## Próximas etapas

<CardGroup cols={2}>
  <Card title="Obter acesso" icon="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/VFX2XSyPqtT4SVsH/icons/xds/icon-key.svg?fit=max&auto=format&n=VFX2XSyPqtT4SVsH&q=85&s=4fef3b633239874012e963a718d02e7b" href="/x-api/getting-started/getting-access" width="24" height="24" data-path="icons/xds/icon-key.svg">
    Cadastre-se e crie seu primeiro app.
  </Card>

  <Card title="Fazer sua primeira solicitação" icon="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/CJEW78ZoFC_WB4AV/icons/xds/icon-rocket.svg?fit=max&auto=format&n=CJEW78ZoFC_WB4AV&q=85&s=c4d643f2a562a30abeccca3349337f50" href="/x-api/getting-started/make-your-first-request" width="24" height="24" data-path="icons/xds/icon-rocket.svg">
    Chame a API em poucos minutos.
  </Card>
</CardGroup>