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

# X API

> Acesso programático ao X com endpoints REST v2 para Posts, usuários, Spaces, listas, DMs e tendências, com preços de pagamento por uso e SDKs modernos.

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

A X API oferece acesso programático à conversa pública do X. Leia posts, publique conteúdo, gerencie usuários e analise tendências — tudo por meio de endpoints REST modernos com preços flexíveis de pagamento por uso.

<CardGroup cols={3}>
  <Card title="Começar" icon="rocket" href="/x-api/getting-started/make-your-first-request">
    Crie um app e faça sua primeira solicitação em minutos.
  </Card>

  <Card title="Referência da API" icon="code" href="/x-api/posts/create-post">
    Explore todos os endpoints disponíveis.
  </Card>

  <Card title="SDKs" icon="cube" href="/tools-and-libraries">
    Bibliotecas oficiais em Python e TypeScript.
  </Card>
</CardGroup>

***

## O que você pode construir

<CardGroup cols={3}>
  <Card title="Posts" icon="message" href="/x-api/posts/lookup/introduction">
    Pesquise, recupere e publique posts. Acesse linhas do tempo, threads e posts citados.
  </Card>

  <Card title="Usuários" icon="user" href="/x-api/users/lookup/introduction">
    Consulte usuários, gerencie quem você segue, bloqueia e silencia.
  </Card>

  <Card title="Spaces" icon="microphone" href="/x-api/spaces/lookup/introduction">
    Encontre conversas de áudio ao vivo e seus participantes.
  </Card>

  <Card title="Mensagens diretas" icon="envelope" href="/x-api/direct-messages/lookup/introduction">
    Envie e receba mensagens privadas.
  </Card>

  <Card title="Listas" icon="list" href="/x-api/lists/list-lookup/introduction">
    Crie e gerencie listas selecionadas de contas.
  </Card>

  <Card title="Tendências" icon="arrow-trend-up" href="/x-api/trends/trends-by-woeid/introduction">
    Acesse tópicos em alta por localização.
  </Card>
</CardGroup>

***

## Preços

A X API utiliza preços de **pagamento por uso**. Sem assinaturas — pague apenas pelo que usar.

<CardGroup cols={2}>
  <Card title="Escalabilidade flexível" icon="chart-line">
    Comece pequeno e cresça. Os custos escalam conforme o seu uso real.
  </Card>

  <Card title="Sem compromissos" icon="unlock">
    Sem contratos ou gasto mínimo. Pare quando quiser.
  </Card>

  <Card title="Acompanhamento em tempo real" icon="gauge-high">
    Monitore o uso e os custos ao vivo no Developer Console.
  </Card>

  <Card title="Baseado em créditos" icon="coins">
    Compre créditos antecipadamente. Eles são debitados conforme você usa a API.
  </Card>
</CardGroup>

<Tip>
  Ganhe créditos gratuitos da [xAI API](https://docs.x.ai) ao comprar créditos da X API — até 20% de retorno com base no seu gasto. [Saiba mais](/x-api/getting-started/pricing#free-xai-api-credits)
</Tip>

<div className="mt-6 flex gap-4">
  <Button href="/x-api/getting-started/pricing">Detalhes de preços</Button>
  <Button href="https://console.x.com">Comprar créditos</Button>
</div>

***

## Principais recursos

<Tabs>
  <Tab title="Acesso a dados">
    ### Objetos de dados ricos

    Acesse dados detalhados e estruturados de posts, usuários, mídia e muito mais:

    * **Posts**: texto completo, métricas, entidades, anotações, threads de conversa
    * **Usuários**: perfis, contagens de seguidores, status de verificação
    * **Mídia**: imagens, vídeos, GIFs com metadados
    * **Enquetes**: opções e contagens de votos

    Personalize as respostas com [fields](/x-api/fundamentals/fields) e [expansions](/x-api/fundamentals/expansions) para obter exatamente os dados de que precisa.
  </Tab>

  <Tab title="Streaming quase em tempo real">
    ### Filtered stream

    Receba posts quase em tempo real conforme são publicados. Defina até 1.000 regras de filtragem para receber apenas os posts correspondentes.

    ```bash theme={null}
    # Add a rule
    curl -X POST "https://api.x.com/2/tweets/search/stream/rules" \
      -H "Authorization: Bearer $TOKEN" \
      -d '{"add": [{"value": "from:xdevelopers"}]}'

    # Connect to stream
    curl "https://api.x.com/2/tweets/search/stream" \
      -H "Authorization: Bearer $TOKEN"
    ```

    [Saiba mais sobre filtered stream →](/x-api/posts/filtered-stream/introduction)
  </Tab>

  <Tab title="Pesquisa e análise">
    ### Pesquisa em arquivo completo

    Pesquise todo o histórico de posts públicos — desde 2006. Construa consultas com operadores para usuários, palavras-chave, datas e muito mais.

    ```bash theme={null}
    curl "https://api.x.com/2/tweets/search/all?query=AI%20lang:en" \
      -H "Authorization: Bearer $TOKEN"
    ```

    ### Métricas

    Acesse métricas de engajamento, incluindo impressões, curtidas, reposts, respostas e visualizações de vídeo.

    [Saiba mais sobre pesquisa →](/x-api/posts/search/introduction)
  </Tab>
</Tabs>

***

## Início rápido

<Steps>
  <Step title="Crie uma conta de desenvolvedor">
    Cadastre-se em [console.x.com](https://console.x.com) e crie um app.
  </Step>

  <Step title="Obtenha suas credenciais">
    Gere seu Bearer Token para solicitações app-only.
  </Step>

  <Step title="Faça uma solicitação">
    Tente consultar um usuário:

    ```bash theme={null}
    curl "https://api.x.com/2/users/by/username/xdevelopers" \
      -H "Authorization: Bearer $BEARER_TOKEN"
    ```
  </Step>
</Steps>

<Button href="/x-api/getting-started/make-your-first-request">Guia completo de início rápido</Button>

***

## Ferramentas e bibliotecas

<CardGroup cols={3}>
  <Card title="Python SDK" icon="python" href="/xdks/python/overview">
    Biblioteca oficial em Python com suporte assíncrono.
  </Card>

  <Card title="TypeScript SDK" icon="js" href="/xdks/typescript/overview">
    Biblioteca oficial em TypeScript/JavaScript.
  </Card>

  <Card title="Postman" icon="server" href="https://www.postman.com/xapidevelopers/x-api-public-workspace/collection/34902927-2efc5689-99c6-4ab6-8091-996f35c2fd80">
    Explorador interativo da API.
  </Card>
</CardGroup>

[Veja todas as bibliotecas →](/tools-and-libraries)

***

## Suporte

<CardGroup cols={2}>
  <Card title="Fórum de desenvolvedores" icon="comments" href="https://devcommunity.x.com">
    Obtenha ajuda da comunidade e da equipe do X.
  </Card>

  <Card title="Central de suporte" icon="circle-question" href="https://developer.x.com/en/support/twitter-api.html">
    FAQs e guias de solução de problemas.
  </Card>
</CardGroup>