> ## 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.
# 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
;
};
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.
Crie um app e faça sua primeira solicitação em minutos.
Explore todos os endpoints disponíveis.
Bibliotecas oficiais em Python e TypeScript.
***
## O que você pode construir
Pesquise, recupere e publique posts. Acesse linhas do tempo, threads e posts citados.
Consulte usuários, gerencie quem você segue, bloqueia e silencia.
Encontre conversas de áudio ao vivo e seus participantes.
Envie e receba mensagens privadas.
Crie e gerencie listas selecionadas de contas.
Acesse tópicos em alta por localização.
***
## Preços
A X API utiliza preços de **pagamento por uso**. Sem assinaturas — pague apenas pelo que usar.
Comece pequeno e cresça. Os custos escalam conforme o seu uso real.
Sem contratos ou gasto mínimo. Pare quando quiser.
Monitore o uso e os custos ao vivo no Developer Console.
Compre créditos antecipadamente. Eles são debitados conforme você usa a API.
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)
***
## Principais recursos
### 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.
### 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)
### 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)
***
## Início rápido
Cadastre-se em [console.x.com](https://console.x.com) e crie um app.
Gere seu Bearer Token para solicitações app-only.
Tente consultar um usuário:
```bash theme={null}
curl "https://api.x.com/2/users/by/username/xdevelopers" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
***
## Ferramentas e bibliotecas
Biblioteca oficial em Python com suporte assíncrono.
Biblioteca oficial em TypeScript/JavaScript.
Explorador interativo da API.
[Veja todas as bibliotecas →](/tools-and-libraries)
***
## Suporte
Obtenha ajuda da comunidade e da equipe do X.
FAQs e guias de solução de problemas.